任务状态

已测完

POST

/zt/api/v1/task/batch

任务执行状态查询，taskStatus标记任务执行状态，等待执行、执行中、执行成功、施行失败。executeResult标记任务执行的结果，执行中、执行结束。业务端可使用taskStatus单个字段或与executeResult字段组合判断任务状态。

请求参数

Body 参数application/json

taskIds

array[string]

任务id数组

必需

支持批量查询

示例

{
    "taskIds": ["18c0d2fb79b04cd480498e3031c2bc2f","1e947b72249d4bd48b41667c6f7a3f52"]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/zt/api/v1/task/batch' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskIds": ["18c0d2fb79b04cd480498e3031c2bc2f","1e947b72249d4bd48b41667c6f7a3f52"]
}'

返回响应

🟢200成功

application/json

Body

data

array [object {12}]

必需

string

任务id

可选

startTime

integer

任务开始执行时间

可选

endTime

integer

任务结束时间

可选

documentId

string

文档id

可选

documentVersion

integer

文档版本

可选

executeResult

string

执行结果

可选

"SUCCESS":成功、"FAILED":失败、"PROCESSING": 进行中

taskStatus

string

执行状态

可选

"WAIT_STARTING": 等待、"PROCESSING": 进行中、"FINISHED"：执行结束

createUser

null

可选

createTime

integer

任务创建时间

可选

taskType

string

任务类型

可选

errorMsg

null

错误原因

可选

progress

string

任务进度百分比，部分任务支持该字段

可选

code

integer

必需

msg

string

必需

示例

{
    "data": [
        {
            "id": "40413e78a9604357bfde0257c0a19b2a",
            "startTime": 1700536100014,
            "endTime": 1700536100014,
            "documentId": null,
            "documentVersion": null,
            "executeResult": "FAILED",
            "taskStatus": "FINISHED",
            "createUser": null,
            "createTime": 1700536093045,
            "taskType": "convert-file",
            "errorMsg": null
        }
    ],
    "code": 0,
    "msg": "成功"
}

修改于 2025-06-19 02:59:23

任务管理

任务列表