English

get_qzone_msg_list

get_qzone_msg_list只读空间

获取 QQ 空间说说列表（默认机器人自己的空间）

Call via POST http://127.0.0.1:3000/get_qzone_msg_list (JSON params as the body) or WebSocket.

Parameters

Param	Type	Required	Default	Description
`target_uin`	uint	–		目标 QQ 号，省略则取机器人自己
`pos`	int	–	`0`	起始偏移
`num`	int	–	`20`	本页数量

Returns (data)

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

Every response is wrapped in the standard envelope: { "status": "ok", "retcode": 0, "data": ... }. The table below describes data.

Field	Type	Required	Description
`total`	integer	✓	账号说说总数（非本页数量）
`msglist`	object[]	✓	本页说说数组

Raw 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"
  ]
}

Examples

curl

Python

JavaScript

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}'

Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.

ON THIS PAGE

get_qzone_msg_list#

Parameters#

Returns (data)#

Examples#

get_qzone_msg_list

Parameters

Returns (data)

Examples