SnowLuma
Home
Quick Start
Deploy
MCP
SDK
API
Developer
Home
Quick Start
Deploy
MCP
SDK
API
Developer

get_group_album_list

get_group_album_list只读群相册

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

Parameters

Param Type Required Default Description
group_id uint ✓ 群号

Returns (data)

群相册列表数组，每项为一个相册的基本信息。

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

data is an array; each element:

Field Type Required Description
id string ✓ 相册 id
name string ✓ 相册名称
picNum integer ✓ 相册内照片数量
createTime integer ✓ 相册创建时间（unix 秒）
Raw JSON Schema
{
  "type": "array",
  "description": "群相册列表",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "相册 id"
      },
      "name": {
        "type": "string",
        "description": "相册名称"
      },
      "picNum": {
        "type": "integer",
        "description": "相册内照片数量"
      },
      "createTime": {
        "type": "integer",
        "description": "相册创建时间（unix 秒）"
      }
    },
    "required": [
      "id",
      "name",
      "picNum",
      "createTime"
    ]
  }
}

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_group_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