get_qzone_msg_list

get_qzone_msg_list只读空间
获取 QQ 空间说说列表(默认机器人自己的空间)

通过 POST http://127.0.0.1:3000/get_qzone_msg_list(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
target_uin uint 目标 QQ 号,省略则取机器人自己
pos int 0 起始偏移
num int 20 本页数量

返回 (data)

说说列表对象,含说说总数与本页说说数组。

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

字段 类型 必填 说明
total integer 账号说说总数(非本页数量)
msglist object[] 本页说说数组
原始 JSON Schema
{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "账号说说总数(非本页数量)"
    },
    "msglist": {
      "type": "array",
      "description": "本页说说数组",
      "items": {
        "type": "object",
        "properties": {
          "tid": {
            "type": "string",
            "description": "说说 id(delete/comment/like 的句柄)"
          },
          "content": {
            "type": "string",
            "description": "说说正文"
          },
          "time": {
            "type": "integer",
            "description": "发表时间(unix 秒)"
          },
          "comment_num": {
            "type": "integer",
            "description": "评论数"
          },
          "is_private": {
            "type": "boolean",
            "description": "是否仅自己可见"
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "图片 URL 列表(每图取最大可用变体)"
          }
        },
        "required": [
          "tid",
          "content",
          "time",
          "comment_num",
          "is_private",
          "images"
        ]
      }
    }
  },
  "required": [
    "total",
    "msglist"
  ]
}

调用示例

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_qzone_msg_list \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"target_uin":0,"pos":0,"num":20}'
在用 AI 助手?

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