欢迎使用「任务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: 通过page
和per_page
参数控制,例如page=2&per_page=20
Q: 支持哪些过滤条件?
A: 可通过status
参数过滤(支持pending
、in_progress
、completed
)