get_group_album_media_list

get_group_album_media_list只读群相册

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

Parameters

Param Type Required Default Description
group_id uint 群号
album_id string
attach_info string ""

Returns (data)

相册媒体列表及下一页分页游标:{mediaList, nextAttachInfo}。

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

Field Type Required Description
mediaList object[] 相册媒体项列表(各项字段不固定)
nextAttachInfo string 下一页分页游标(空串表示无更多)
Raw JSON Schema
{
  "type": "object",
  "properties": {
    "mediaList": {
      "type": "array",
      "description": "相册媒体项列表(各项字段不固定)",
      "items": {
        "type": "object"
      }
    },
    "nextAttachInfo": {
      "type": "string",
      "description": "下一页分页游标(空串表示无更多)"
    }
  },
  "required": [
    "mediaList",
    "nextAttachInfo"
  ]
}

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/get_group_album_media_list \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"group_id":123456,"album_id":"","attach_info":""}'
Using an AI assistant?

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