任务管理
任务管理接口用于创建和管理后台任务。所有接口都需要开发者权限。
获取任务列表
获取任务列表。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| page | integer | 否 | 页码,默认1 |
| size | integer | 否 | 每页数量 |
GET /dev/task/list?page=1&size=10
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
获取任务详情
获取指定任务的详细信息。请求参数
GET /dev/task/task_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
创建任务
创建新的任务。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| name | string | 是 | 任务名称 |
| description | string | 否 | 任务描述 |
| config | object | 否 | 任务配置 |
POST /dev/task
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"name": "新任务",
"description": "这是一个新任务",
"config": {
"type": "data_processing",
"priority": "high"
}
}
更新任务
更新指定任务的信息。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| id | string | 是 | 任务ID |
| name | string | 否 | 任务名称 |
| description | string | 否 | 任务描述 |
| config | object | 否 | 任务配置 |
PUT /dev/task/task_124
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"name": "更新后的任务",
"description": "这是更新后的任务描述"
}
删除任务
删除指定的任务。请求参数
DELETE /dev/task/task_124
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
错误码说明
错误码说明
| 错误码 | 说明 |
|---|
| 400 | 请求参数错误 |
| 401 | 未授权或令牌无效 |
| 403 | 权限不足(需要开发者权限) |
| 404 | 任务不存在 |
| 422 | 请求参数验证失败 |
| 500 | 服务器错误 |