通过 POST http://127.0.0.1:3000/get_collection_list（请求体为 JSON 参数）或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
category |
int | – | 0 |
收藏分类 ID；0 表示全部分类 |
count |
int | – | 50 |
最多返回的收藏数量 |
返回收藏条目、是否还有更多数据及底部时间游标。
所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
errCode |
integer | ✓ | |
errMsg |
string | ✓ | |
collectionSearchList |
object | ✓ |
{
"type": "object",
"properties": {
"errCode": {
"type": "integer"
},
"errMsg": {
"type": "string"
},
"collectionSearchList": {
"type": "object",
"properties": {
"collectionItemList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cid": {
"type": "string"
},
"type": {
"type": "integer"
},
"status": {
"type": "integer"
},
"author": {
"type": "object",
"properties": {
"type": {
"type": "integer"
},
"numId": {
"type": "string"
},
"strId": {
"type": "string"
},
"groupId": {
"type": "string"
},
"groupName": {
"type": "string"
},
"uid": {
"type": "string"
}
},
"required": [
"type",
"numId",
"strId",
"groupId",
"groupName",
"uid"
]
},
"bid": {
"type": "integer"
},
"category": {
"type": "integer"
},
"createTime": {
"type": "string"
},
"collectTime": {
"type": "string"
},
"modifyTime": {
"type": "string"
},
"sequence": {
"type": "string"
},
"shareUrl": {
"type": "string"
},
"customGroupId": {
"type": "integer"
},
"securityBeat": {
"type": "boolean"
},
"summary": {
"type": "object",
"properties": {
"textSummary": {
"type": [
"object",
"null"
]
},
"linkSummary": {
"type": [
"object",
"null"
]
},
"gallerySummary": {
"type": [
"object",
"null"
]
},
"audioSummary": {
"type": [
"object",
"null"
]
},
"videoSummary": {
"type": [
"object",
"null"
]
},
"fileSummary": {
"type": [
"object",
"null"
]
},
"locationSummary": {
"type": [
"object",
"null"
]
},
"richMediaSummary": {
"type": [
"object",
"null"
]
}
},
"required": [
"textSummary",
"linkSummary",
"gallerySummary",
"audioSummary",
"videoSummary",
"fileSummary",
"locationSummary",
"richMediaSummary"
]
}
},
"required": [
"cid",
"type",
"status",
"author",
"bid",
"category",
"createTime",
"collectTime",
"modifyTime",
"sequence",
"shareUrl",
"customGroupId",
"securityBeat",
"summary"
]
}
},
"hasMore": {
"type": "boolean"
},
"bottomTimeStamp": {
"type": "string"
}
},
"required": [
"collectionItemList",
"hasMore",
"bottomTimeStamp"
]
}
},
"required": [
"errCode",
"errMsg",
"collectionSearchList"
]
}curl -X POST http://127.0.0.1:3000/get_collection_list \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <access-token>' \
-d '{"category":0,"count":50}'支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。