get_group_album_media_list

get_group_album_media_list只读群相册

通过 POST http://127.0.0.1:3000/get_group_album_media_list(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
group_id uint 群号
album_id string
attach_info string ""

返回 (data)

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

所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

字段 类型 必填 说明
mediaList object[] 相册媒体项列表(各项字段不固定)
nextAttachInfo string 下一页分页游标(空串表示无更多)
原始 JSON Schema
{
  "type": "object",
  "properties": {
    "mediaList": {
      "type": "array",
      "description": "相册媒体项列表(各项字段不固定)",
      "items": {
        "type": "object"
      }
    },
    "nextAttachInfo": {
      "type": "string",
      "description": "下一页分页游标(空串表示无更多)"
    }
  },
  "required": [
    "mediaList",
    "nextAttachInfo"
  ]
}

调用示例

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":""}'
在用 AI 助手?

支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入