题库与练习/Bearer

Read recent practice activity

List the current user's factual standalone practice records. It supports an Asia/Shanghai date range, subject, status, and pagination and never returns mock sessions. Every result exposes sessionId; use the independent review Domain for question-level evidence. This tool does not recommend or diagnose.

Endpoint

POST/api/v1/agent/capabilities/ielts_practice_recent_activity

请求参数

字段	类型	必填	说明
dateFrom	string	否	Optional inclusive local date in YYYY-MM-DD. Explicit dates use the Asia/Shanghai calendar and override timeRange.
dateTo	string	否	Optional inclusive local date in YYYY-MM-DD. Explicit dates use the Asia/Shanghai calendar and override timeRange.
limit	number	否	Result limit, 1-30.
offset	number	否	Pagination offset returned by the preceding call.
status	\| in_progress \| submitted	否	Optional record status. Empty returns all statuses.
subject	\| listening \| reading \| speaking \| writing	否	Optional subject filter. Empty returns every subject.
timeRange	all \| today \| yesterday \| 7d \| 30d	否	Relative record range in the Asia/Shanghai calendar. Ignored when dateFrom or dateTo is supplied.

调用示例

curl -X POST \
  'https://work.ieltsbuddy.igopx.cn/api/v1/agent/capabilities/ielts_practice_recent_activity' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer $IELTS_BUDDY_TOKEN' \
  --data '{"dateFrom":"","dateTo":"","limit":12,"offset":0,"status":"","subject":"","timeRange":"all"}'

请求结构

{
  "type": "object",
  "properties": {
    "dateFrom": {
      "default": "",
      "description": "Optional inclusive local date in YYYY-MM-DD. Explicit dates use the Asia/Shanghai calendar and override timeRange.",
      "type": "string",
      "pattern": "^(?:|\\d{4}-\\d{2}-\\d{2})$"
    },
    "dateTo": {
      "default": "",
      "description": "Optional inclusive local date in YYYY-MM-DD. Explicit dates use the Asia/Shanghai calendar and override timeRange.",
      "type": "string",
      "pattern": "^(?:|\\d{4}-\\d{2}-\\d{2})$"
    },
    "limit": {
      "default": 12,
      "description": "Result limit, 1-30.",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset returned by the preceding call.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000
    },
    "status": {
      "default": "",
      "description": "Optional record status. Empty returns all statuses.",
      "type": "string",
      "enum": [
        "",
        "in_progress",
        "submitted"
      ]
    },
    "subject": {
      "default": "",
      "description": "Optional subject filter. Empty returns every subject.",
      "type": "string",
      "enum": [
        "",
        "listening",
        "reading",
        "speaking",
        "writing"
      ]
    },
    "timeRange": {
      "default": "all",
      "description": "Relative record range in the Asia/Shanghai calendar. Ignored when dateFrom or dateTo is supplied.",
      "type": "string",
      "enum": [
        "all",
        "today",
        "yesterday",
        "7d",
        "30d"
      ]
    }
  },
  "required": [
    "dateFrom",
    "dateTo",
    "limit",
    "offset",
    "status",
    "subject",
    "timeRange"
  ],
  "additionalProperties": false
}

统一响应

接口结果位于 data；code 为 0 表示调用成功。

{
  "code": 0,
  "data": {},
  "message": "ok"
}

错误码

40040001请求参数不符合接口契约

40140101缺少或使用了无效的访问令牌

40340301访问令牌不包含接口所需权限

40440401接口或目标资源不存在