通过 POST http://127.0.0.1:3000/get_group_album_media_list(请求体为 JSON 参数)或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
group_id |
uint | ✓ | 群号 | |
album_id |
string | ✓ | ||
attach_info |
string | – | "" |
相册媒体列表及下一页分页游标:{mediaList, nextAttachInfo}。
所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
mediaList |
object[] | ✓ | 相册媒体项列表(各项字段不固定) |
nextAttachInfo |
string | ✓ | 下一页分页游标(空串表示无更多) |
支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入。