消息 (Message)
类型定义
Message
| 字段 | 类型 | 描述 |
|---|---|---|
id | string | 消息 ID |
content | string | 消息内容 |
channel | Channel? | 频道对象 |
guild | Guild? | 群组对象 |
member | Member? | 群组成员对象 |
user | User? | 用户对象 |
created_at | number? | 消息发送的时间戳 |
updated_at | number? | 消息修改的时间戳 |
API
发送消息
POST /message.create| 字段 | 类型 | 描述 |
|---|---|---|
channel_id | string | 频道 ID |
content | string | 消息内容 |
发送消息。返回一个 Message 对象构成的数组。
获取消息
POST /message.get| 字段 | 类型 | 描述 |
|---|---|---|
channel_id | string | 频道 ID |
message_id | string | 消息 ID |
获取特定消息。返回一个 Message 对象。必需资源：channel，user。
撤回消息
POST /message.delete| 字段 | 类型 | 描述 |
|---|---|---|
channel_id | string | 频道 ID |
message_id | string | 消息 ID |
撤回特定消息。
编辑消息
POST /message.update| 字段 | 类型 | 描述 |
|---|---|---|
channel_id | string | 频道 ID |
message_id | string | 消息 ID |
content | string | 消息内容 |
编辑特定消息。
获取消息列表
POST /message.list| 字段 | 类型 | 描述 |
|---|---|---|
channel_id | string | 频道 ID |
next | string? | 分页令牌 |
direction | Direction? | 查询方向 |
limit | number? | 消息数量限制 |
order | Order? | 对结果排序 |
获取频道消息列表。返回一个 Message 的双向分页列表。必需资源：user。
next参数默认值为空，表示从最新消息开始查询。此时direction参数只能为before。direction参数默认为before。order参数默认为asc(无论查询方向)。limit参数的默认值与平台默认值保持一致。如果平台 API 没有设定默认值，则可以自行设定，推荐值为 50。如果用户传入值超出平台要求的上限，则应当改为使用平台的上限值，而不是返回错误。开发者应当使用返回值中prev或next的存在性判断是否有更多数据，而非依赖于返回值中data的长度。
事件
message-created
当消息被创建时触发。必需资源：channel，message，user。
message-updated
当消息被编辑时触发。必需资源：channel，message，user。