# 创建频道身份组

# 接口

POST /guilds/{guild_id}/roles
1

# 功能描述

用于在guild_id 指定的频道下创建一个身份组。

  • 需要使用的 token 对应的用户具备创建身份组权限。如果是机器人,要求被添加为管理员。
  • 参数为非必填,但至少需要传其中之一,默认为空或 0

# Content-Type

application/json
1

# 参数

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

# 返回

字段名 类型 描述
role_id string 身份组 ID
role Role 对象 所创建的频道身份组对象

# 错误码

详见错误码

# 示例

请求数据包

{
  "name": "test",
  "color": 99999,
  "hoist": "1"
}
1
2
3
4
5

响应数据包

{
  "role_id": "10177739",
  "role": {
    "id": "10177739",
    "name": "test",
    "color": 99999,
    "hoist": 1,
    "number": 0,
    "member_limit": 2000
  }
}
1
2
3
4
5
6
7
8
9
10
11
手机QQ扫码
开发者社区
加入官方频道开发者社区