创建子频道

接口

POST /guilds/{guild_id}/channels

功能描述

用于在 guild_id 指定的频道下创建一个子频道。

• 要求操作人具有管理频道的权限，如果是机器人，则需要将机器人设置为管理员。
• 创建成功后，返回创建成功的子频道对象，同时会触发一个频道创建的事件通知。

注意

• 公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
• 注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

参数

字段名	类型	描述
name	string	子频道名称
type	int	子频道类型 ChannelType
sub_type	int	子频道子类型 ChannelSubType
position	int	子频道排序，必填；当子频道类型为 子频道分组（ChannelType=4）时，必须大于等于 2
parent_id	string	子频道所属分组ID
private_type	int	子频道私密类型 PrivateType
private_user_ids	string 数组	子频道私密类型成员 ID
speak_permission	int	子频道发言权限 SpeakPermission
application_id	string	应用类型子频道应用 AppID，仅应用子频道需要该字段

返回

返回Channel 对象。

错误码

详见错误码。

示例

请求数据包

{
  "name": "私密子频道",
  "type": 0,
  "position": 1,
  "parent_id": "123456",
  "owner_id": "0",
  "sub_type": 0,
  "private_type": 1
}

响应数据包

{
  "id": "xxxxxx",
  "guild_id": "xxxxxx",
  "name": "私密子频道",
  "type": 1,
  "position": 7,
  "parent_id": "123456",
  "owner_id": "xxxxxx",
  "sub_type": 0
}