消息 API
send_private_message 发送私聊消息
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| message | Array<OutgoingSegment> | 消息内容 |
返回值
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_seq | int64 | 消息序列号 |
| time | int64 | 消息发送时间 |
| client_seq | int64 | 消息的客户端序列号 |
send_group_message 发送群消息
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| message | Array<OutgoingSegment> | 消息内容 |
返回值
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_seq | int64 | 消息序列号 |
| time | int64 | 消息发送时间 |
get_message 获取消息
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_scene | string | 消息场景（可能值：friend, group, temp） |
| peer_id | int64 | 好友 QQ 号或群号 |
| message_seq | int64 | 消息序列号 |
返回值
| 字段名 | 类型 | 描述 |
|---|---|---|
| message | IncomingMessage | 消息内容 |
get_history_messages 获取历史消息
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| message_scene | string | 消息场景（可能值：friend, group, temp） |
| peer_id | int64 | 好友 QQ 号或群号 |
| start_message_seq | int64 | 起始消息序列号，不提供则从最新消息开始（可选） |
| direction | string | 消息获取方向（可能值：newer, older） |
| limit | int32 | 获取的最大消息数量（默认值：20） |
返回值
| 字段名 | 类型 | 描述 |
|---|---|---|
| messages | Array<IncomingMessage> | 获取到的消息，部分消息可能不存在，如撤回的消息 |
get_resource_temp_url 获取临时资源链接
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| resource_id | string | 资源 ID |
返回值
| 字段名 | 类型 | 描述 |
|---|---|---|
| url | string | 临时资源链接 |
get_forwarded_messages 获取合并转发消息内容
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| forward_id | string | 转发消息 ID |
返回值
| 字段名 | 类型 | 描述 |
|---|---|---|
| messages | Array<IncomingMessage> | 转发消息内容 |
recall_private_message 撤回私聊消息
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| message_seq | int64 | 消息序列号 |
| client_seq | int64 | 客户端序列号 |
返回值
此 API 无返回值。
recall_group_message 撤回群消息
参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| message_seq | int64 | 消息序列号 |
返回值
此 API 无返回值。