English

get_qun_album_list

get_qun_album_list只读群相册

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

Parameters

Param	Type	Required	Default	Description
`group_id`	uint	✓		群号

Returns (data)

NapCat 风格的相册列表封套：{album_list, attach_info, has_more}（本实现 attach_info 恒为空串、has_more 恒为 false）。

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

Field	Type	Required	Description
`album_list`	object[]	✓	相册列表
`attach_info`	string	✓	分页游标（本 web 实现一次取满，恒为空串）
`has_more`	boolean	✓	是否还有更多（本 web 实现恒为 false）

Raw JSON Schema

{
  "type": "object",
  "properties": {
    "album_list": {
      "type": "array",
      "description": "相册列表",
      "items": {
        "type": "object",
        "properties": {
          "album_id": {
            "type": "string",
            "description": "相册 id"
          },
          "album_name": {
            "type": "string",
            "description": "相册名称"
          },
          "create_time": {
            "type": "integer",
            "description": "相册创建时间（unix 秒）"
          },
          "pic_num": {
            "type": "integer",
            "description": "相册内照片数量"
          }
        },
        "required": [
          "album_id",
          "album_name",
          "create_time",
          "pic_num"
        ]
      }
    },
    "attach_info": {
      "type": "string",
      "description": "分页游标（本 web 实现一次取满，恒为空串）"
    },
    "has_more": {
      "type": "boolean",
      "description": "是否还有更多（本 web 实现恒为 false）"
    }
  },
  "required": [
    "album_list",
    "attach_info",
    "has_more"
  ]
}

Examples

curl

Python

JavaScript

SnowLuma SDK

curl -X POST http://127.0.0.1:3000/get_qun_album_list \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456}'

Using an AI assistant?

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

ON THIS PAGE

get_qun_album_list#

Parameters#

Returns (data)#

Examples#

get_qun_album_list

Parameters

Returns (data)

Examples