频道 (Channel)
类型定义
Channel
| 字段 | 类型 | 描述 |
|---|---|---|
| id | string | 频道 ID |
| type | Channel.Type | 频道类型 |
| name | string? | 频道名称 |
| parent_id | string? | 父频道 ID |
Channel.Type
| 名称 | 值 | 描述 |
|---|---|---|
| TEXT | 0 | 文本频道 |
| DIRECT | 1 | 私聊频道 |
| CATEGORY | 2 | 分类频道 |
| VOICE | 3 | 语音频道 |
API
获取群组频道
POST/channel.get| 字段 | 类型 | 描述 |
|---|---|---|
| channel_id | string | 频道 ID |
根据 ID 获取频道。返回一个 Channel 对象。
获取群组频道列表
POST/channel.list| 字段 | 类型 | 描述 |
|---|---|---|
| guild_id | string | 群组 ID |
| next | string? | 分页令牌 |
获取群组中的全部频道。返回一个 Channel 的 分页列表。
创建群组频道
POST/channel.create| 字段 | 类型 | 描述 |
|---|---|---|
| guild_id | string | 群组 ID |
| data | Channel | 频道数据 |
创建群组频道。返回一个 Channel 对象。
修改群组频道
POST/channel.update| 字段 | 类型 | 描述 |
|---|---|---|
| channel_id | string | 频道 ID |
| data | Channel | 频道数据 |
修改群组频道。
删除群组频道
POST/channel.delete| 字段 | 类型 | 描述 |
|---|---|---|
| channel_id | string | 频道 ID |
删除群组频道。
禁言群组频道 实验性
POST/channel.mute| 字段 | 类型 | 描述 |
|---|---|---|
| channel_id | string | 频道 ID |
| duration | number | 禁言时长 (毫秒) |
禁言群组频道。如果传入的禁言时长为 0 则表示解除禁言。
创建私聊频道
POST/user.channel.create| 字段 | 类型 | 描述 |
|---|---|---|
| user_id | string | 用户 ID |
| guild_id | string? | 群组 ID |
创建一个私聊频道。返回一个 Channel 对象。