创建频道 API 权限授权链接 v2.8.0

用于创建 API 接口权限授权链接，该链接指向 guildID 对应的频道 。调用成功后，参数指定的子频道会受到一条“申请授权【xxx】权限”消息，管理员点击可进行机器人 API 权限授予。

注意

• 需要建立 ws 连接。
• 每天只能在一个频道内发 3 条（默认值）频道权限授权链接，如需调整，请联系平台申请权限。

使用示例

async function demo() {
  let { data } = await client.guildPermissionsApi.postPermissionDemand(guildID, permissionDemandObj);

  // e.g.
  // let { data } = await client.guildPermissionsApi.postPermissionDemand('123456', {
  //   channel_id: '112233',
  //   api_identify: {
  //     path: '/guilds/{guild_id}',
  //     method: 'GET',
  //   },
  //   desc: '频道权限',
  // });
}

参数说明

字段名	必填	类型	描述
guildID	是	string	频道 ID
permissionDemandObj	是	PermissionDemandToCreate	授权链接对象

PermissionDemandToCreate

字段名	必填	类型	描述
channel_id	是	string	授权链接发送的子频道 ID
api_identify	是	APIPermissionDemandIdentify	API 权限需求标识对象
desc	否	string	机器人申请对应的 API 接口权限后可以使用功能的描述

APIPermissionDemandIdentify

字段名	类型	描述
path	string	API 接口名，例如 /guilds/{guild_id}/members/{user_id}
method	string	请求方法，例如 GET

返回说明

返回 APIPermissionDemand对象。

APIPermissionDemand

字段名	类型	描述
guild_id	string	申请接口权限的频道 ID
channel_id	string	接口权限需求授权链接发送的子频道 ID
api_identify	APIPermissionDemandIdentify	权限接口唯一标识
title	string	接口权限链接中的接口权限描述信息
desc	string	接口权限链接中的机器人可使用功能的描述信息

返回示例

data：

{
  "guild_id": "123456",
  "channel_id": "112233",
  "api_identify": {
    "path": "/guilds/{guild_id}",
    "method": "GET"
  },
  "title": "申请授权【获取频道】权限",
  "desc": "允许授权后才能正常使用机器人「频道权限」功能"
}

此时打开“channel_id”对应的频道，可看到一条机器人发出的 API 授权申请消息。