欢迎使用「任务API查询接口」,该接口允许您通过HTTP GET请求获取任务相关数据。以下是使用说明:

基本用法 🛠️

GET /developer-center/tasks/api/query?task_id=12345
  • task_id:必填参数,用于指定查询的任务唯一标识符
  • page:可选参数,分页页码(默认值为1)
  • per_page:可选参数,每页返回的数据条数(默认值为10)

请求参数详解 🔍

参数名 类型 描述
task_id string 必须提供有效任务ID
status string 可选过滤条件(如:pending/completed
sort string 排序方式(如:created_at

示例:/developer-center/tasks/api/query?task_id=67890&status=completed 可查询已完成的任务详情

响应示例 📡

{
  "task": {
    "id": "67890",
    "name": "性能优化任务",
    "status": "completed",
    "created_at": "2023-09-15T08:00:00Z"
  },
  "links": {
    "self": "/developer-center/tasks/api/query?task_id=67890",
    "documentation": "/developer-center/tasks/api/overview"
  }
}

常见问题 ❓

  • Q: 如何分页获取更多数据?
    A: 通过 pageper_page 参数控制,例如 page=2&per_page=20

  • Q: 支持哪些过滤条件?
    A: 可通过 status 参数过滤(支持 pendingin_progresscompleted

扩展阅读 📖

了解更多关于任务API的设计规范

API_概述