简体中文

get_friend_msg_history

get_friend_msg_history只读扩展

获取好友消息历史（无锚点时从服务器获取最新双向记录）

通过 POST http://127.0.0.1:3000/get_friend_msg_history（请求体为 JSON 参数）或 WebSocket 调用。

输入参数

参数	类型	必填	默认	说明
`user_id`	uint	✓
`message_id`	int	–	`0`
`count`	int	–	`20`	无锚点时从 QQ 服务器获取最新双向历史；服务器或身份解析失败时动作失败，不返回不完整的本地缓存
`reverse_order`	bool	–	`true`	仅在 message_id 非 0 时生效；true 返回锚点及更旧消息，false 返回锚点及更新消息

返回 (data)

{ messages }：好友消息事件对象数组（每项为 OneBot 消息事件，内部字段不固定）。

所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

字段	类型	必填	说明
`messages`	object[]	✓	消息事件对象数组

原始 JSON Schema

{
  "type": "object",
  "properties": {
    "messages": {
      "type": "array",
      "description": "消息事件对象数组",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "messages"
  ]
}

调用示例

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_friend_msg_history \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"user_id":10001,"message_id":0,"count":20,"reverse_order":true}'

在用 AI 助手？

支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。

ON THIS PAGE

get_friend_msg_history#

输入参数#

返回 (data)#

调用示例#

get_friend_msg_history

输入参数

返回 (data)

调用示例