get_msg

读取框架当前进程已观察到的 OneBot 消息数据，不请求 QQ 历史消息。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

只查询当前账号与协议的消息缓存。message_id 不是 QQ 上游序列号；缓存不存在或过期会失败。

适用协议

Android / Linux QQ；查询当前账号实例已接收的消息缓存。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "get_msg",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "message_id": 1
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
message_id	integer	是	消息事件或发送结果中的框架消息编号

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
message_id	integer	消息事件或发送结果中的框架消息编号
self_id	integer	当前框架内的账号 QQ 号
protocol_id	integer	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
message_type	string	会话类型
group_id	integer	目标群号
user_id	integer	目标 QQ 号
sender	object	发送者信息
sender.user_id	integer	目标 QQ 号
msg_seq	integer	上游消息序列号
msg_random	integer	上游消息随机数
time	integer	业务时间戳
message	string	消息段数组，结构见消息段参考
raw_message	string	消息纯文本预览