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 秒）
last_upload_time integer ✓ 最后上传时间（unix 秒）
cover object,null ✓ 相册封面；没有封面时为 null
createuin string ✓ 相册创建者 QQ 号
createnickname string ✓ 相册创建者昵称（原始 Unicode）
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 秒）"
      },
      "last_upload_time": {
        "type": "integer",
        "description": "最后上传时间（unix 秒）"
      },
      "cover": {
        "type": [
          "object",
          "null"
        ],
        "description": "相册封面；没有封面时为 null",
        "properties": {
          "type": {
            "type": "integer",
            "description": "封面媒体类型"
          },
          "image": {
            "type": [
              "object",
              "null"
            ],
            "description": "封面图片信息",
            "properties": {
              "name": {
                "type": "string",
                "description": "图片名称"
              },
              "sloc": {
                "type": "string",
                "description": "图片短定位标识"
              },
              "lloc": {
                "type": "string",
                "description": "图片长定位标识"
              },
              "photoUrls": {
                "type": "array",
                "description": "不同规格的封面地址",
                "items": {
                  "type": "object",
                  "properties": {
                    "spec": {
                      "type": "integer",
                      "description": "图片规格"
                    },
                    "url": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "url": {
                          "type": "string",
                          "description": "封面地址"
                        },
                        "width": {
                          "type": "integer",
                          "description": "封面宽度"
                        },
                        "height": {
                          "type": "integer",
                          "description": "封面高度"
                        }
                      },
                      "required": [
                        "url",
                        "width",
                        "height"
                      ]
                    }
                  },
                  "required": [
                    "spec",
                    "url"
                  ]
                }
              },
              "defaultUrl": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "封面地址"
                  },
                  "width": {
                    "type": "integer",
                    "description": "封面宽度"
                  },
                  "height": {
                    "type": "integer",
                    "description": "封面高度"
                  }
                },
                "required": [
                  "url",
                  "width",
                  "height"
                ]
              },
              "isGif": {
                "type": "boolean",
                "description": "是否为动图"
              },
              "hasRaw": {
                "type": "boolean",
                "description": "是否有原图"
              }
            },
            "required": [
              "name",
              "sloc",
              "lloc",
              "photoUrls",
              "defaultUrl",
              "isGif",
              "hasRaw"
            ]
          }
        },
        "required": [
          "type",
          "image"
        ]
      },
      "createuin": {
        "type": "string",
        "description": "相册创建者 QQ 号"
      },
      "createnickname": {
        "type": "string",
        "description": "相册创建者昵称（原始 Unicode）"
      }
    },
    "required": [
      "id",
      "name",
      "picNum",
      "createTime",
      "last_upload_time",
      "cover",
      "createuin",
      "createnickname"
    ]
  }
}

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