DELETE /tasks
描述
删除任务数据,并返回空 json 对象
该 route 处理发送到 /tasks/{id} 或 /tasks 路径的 DELETE 请求。
每次请求可以删除一个或多个任务。如果存在子任务,所有子任务也会一并删除。
| HTTP 方法 | Route | 查询参数 |
|---|---|---|
| DELETE | /tasks | id |
查 询参数
要删除的任务 ID 在请求行中发送。
| 名称 | 类型 | 描述 |
|---|---|---|
id | number | 可选。要删除的任务 ID。 |
Payload
服务器需要接收一个包含以下属性的 json 对象:
| 名称 | 类型 | 描述 |
|---|---|---|
batch | array | 可选。要删除的任务 ID 列表。 |
示例:
{
"batch": [1, 2, 3]
}
响应
请求成功时,该 route 返回空 json 对象。
HTTP 状态码表示请求是否成功(response.status == 200)或失败(response.status == 500)。
变更日志:batch payload 在 v1.3 中新增
相关文章: