消息 API
send_private_message 发送私聊消息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| message | OutgoingSegment[] | 消息内容 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_seq | int64 | 消息序列号 |
| time | int64 | 消息发送时间 |
send_group_message 发送群聊消息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| message | OutgoingSegment[] | 消息内容 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_seq | int64 | 消息序列号 |
| time | int64 | 消息发送时间 |
recall_private_message 撤回私聊消息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| message_seq | int64 | 消息序列号 |
输出参数
此 API 无输出参数，请协议端传入 {}。
recall_group_message 撤回群聊消息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| message_seq | int64 | 消息序列号 |
输出参数
此 API 无输出参数，请协议端传入 {}。
get_message 获取消息
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_scene | "friend" | "group" | "temp" | 消息场景 |
| peer_id | int64 | 好友 QQ 号或群号 |
| message_seq | int64 | 消息序列号 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message | IncomingMessage | 消息内容 |
get_history_messages 获取历史消息列表
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_scene | "friend" | "group" | "temp" | 消息场景 |
| peer_id | int64 | 好友 QQ 号或群号 |
| start_message_seq | int64 (optional) | 起始消息序列号，由此开始从新到旧查询，不提供则从最新消息开始 |
| limit | int32 (default: 20) | 期望获取到的消息数量，最多 30 条 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| messages | IncomingMessage[] | 获取到的消息（message_seq 升序排列），部分消息可能不存在，如撤回的消息 |
| next_message_seq | int64 (optional) | 下一页起始消息序列号 |
get_resource_temp_url 获取临时资源链接
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| resource_id | string | 资源 ID |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| url | string | 临时资源链接 |
get_forwarded_messages 获取合并转发消息内容
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| forward_id | string | 转发消息 ID |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| messages | IncomingForwardedMessage[] | 转发消息内容 |
mark_message_as_read 标记消息为已读
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_scene | "friend" | "group" | "temp" | 消息场景 |
| peer_id | int64 | 好友 QQ 号或群号 |
| message_seq | int64 | 标为已读的消息序列号，该消息及更早的消息将被标记为已读 |
输出参数
此 API 无输出参数，请协议端传入 {}。