# 创建频道身份组 v1.0.0

创建一个频道身份组。

# 使用示例

async function demo() {
  let { data } = await client.roleApi.postRole(guildId, roleInfo);
}
1
2
3

注意

需要使用的 token 对应的用户具备创建身份组权限。如果是机器人,要求被添加为管理员。

# 参数说明

字段名 必填 类型 描述
guildId string 频道 ID
roleInfo RoleInfo 频道身份组参数

# RoleInfo

字段名 必填 类型 描述
name string 名称
color number ARGB 的 HEX 十六进制颜色值转换后的十进制数值(例:4294927682)
hoist number 在成员列表中单独展示: 0-否, 1-是

# 返回说明

字段名 类型 描述
role_id string 频道身份组 ID
role GuildRole 频道身份组对象

# GuildRole

字段名 类型 描述
id string 身份组 ID
name string 名称
color number ARGB 的 HEX 十六进制颜色值转换后的十进制数值(例:4294927682)
hoist number 是否在成员列表中单独展示: 0-否, 1-是
number number 人数
member_limit number 成员上限

# 返回示例

data

{
    role_id: 'ROLE_ID',
    role: {
      id: 'ROLE_ID',
      name: '普通成员222',
      color: 4286151052,
      hoist: 0,
      number: 0,
      member_limit: 2000
    }
}
1
2
3
4
5
6
7
8
9
10
11
手机QQ扫码
开发者社区
加入官方频道开发者社区