任务

查看任务状态

接口描述

查看异步任务状态。

接口路径

GET /v1/tasks/:id

请求参数

路径参数

参数名称	示例	备注
id	/v1/tasks/1	查看id为1的任务

返回数据

字段	类型	描述
code	int	状态码（100001表示成功，其它表示异常）
msg	string	状态码描述信息
data	TaskResponse	任务的响应
id	int	任务Id
state	int	任务状态，值含义如下：1：任务执行成功；2：任务正在执行；3：任务执行失败；4：任务执行超时
reason	string	异常时的原因

TaskResponse：

字段	类型	描述
started_at	string	任务开始时间
finished_at	string	任务结束时间
state	int	任务状态，值含义如下：1：任务执行成功；2：任务正在执行；3：任务执行失败；4：任务执行超时

返回数据示例：

{
    "code": 100001,
    "msg": "success",
    "data": {
        "started_at": "2025-07-03T18:43:23.808+08:00",
        "finished_at": "2025-07-03T18:44:23.849+08:00",
        "state": 1
    }
}

任务状态（state）码含义：

• 1：任务执行成功
• 2：任务执行中
• 3：任务执行失败
• 4：任务执行超时