学习者数据/Bearer
List learning footprints
List the authenticated user's unified learning footprint with activity, time-range, search, and pagination filters.
Endpoint
POST
/api/v1/agent/capabilities/ielts_footprints_list请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| kinds | unknown[] | 否 | Activity kinds to include. Empty includes all kinds. |
| limit | number | 否 | limit |
| offset | number | 否 | offset |
| query | string | 否 | Title or description search query. |
| timeRange | all | today | 7d | 30d | 否 | timeRange |
调用示例
curl -X POST \
'https://work.ieltsbuddy.igopx.cn/api/v1/agent/capabilities/ielts_footprints_list' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $IELTS_BUDDY_TOKEN' \
--data '{"kinds":[],"limit":20,"offset":0,"query":"","timeRange":"all"}'请求结构
{
"type": "object",
"properties": {
"kinds": {
"default": [],
"description": "Activity kinds to include. Empty includes all kinds.",
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"chat",
"file",
"mock",
"note",
"practice",
"study"
]
}
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 1000
},
"query": {
"default": "",
"description": "Title or description search query.",
"type": "string"
},
"timeRange": {
"default": "all",
"type": "string",
"enum": [
"all",
"today",
"7d",
"30d"
]
}
},
"required": [
"kinds",
"limit",
"offset",
"query",
"timeRange"
],
"additionalProperties": false
}统一响应
接口结果位于 data;code 为 0 表示调用成功。
{
"code": 0,
"data": {},
"message": "ok"
}错误码
400
40001请求参数不符合接口契约401
40101缺少或使用了无效的访问令牌403
40301访问令牌不包含接口所需权限404
40401接口或目标资源不存在