查询任务-QueryTaskQueues

单任务查询任务排队数量

查询除批次插入(BatchInsertTask)任务以外的其他任务插入的转换信息,转换完成后,通过该接口可以获取当前任务排队情况,获取前面还有多少个任务在排队处理。

请求方式: POST

URL地址:  [YunapiUrl]/nds_requests/common/QueryTaskQueues

Table 1. 接口说明
接口说明
在任务插入成功,获取到taskID之后,根据taskID查询任务信息,获取任务排队情况。注意任务状态未0时,表示任务还未处理
Table 2. 请求参数
字段名 变量名 必填 类型 说明
任务ID taskID String 任务ID
Table 3. 返回参数
字段名 变量名 必填 类型 说明
接口状态 status json 接口的调用状态,包含接口返回码和错误信息
接口数据 data json 接口的返回数据,包含任务详细信息
Table 4. 变量status的属性值
字段名 属性名 必填 类型 说明
返回码 code String 枚举值-code 返回码说明
错误信息 msg String 错误信息
Table 5. 变量data的属性值
字段名 属性名 必填 类型 说明
任务状态 status int 任务状态,见枚举值-status 任务状态定义
排队数量 number int 0:处理中, > 0 表示当前任务前面排队数量,-1表示未进入处理队列

示例

请求示例:

curl --location 'https://api.3dopen.cn/nds_requests/Common/QueryTaskQueues' \
--header 'timeStampData: 1727087763' \
--header 'partnerID: xxx' \
--header 'shaKeyData: xxx' \
--form 'taskID="1"'

返回示例:

{
    "data": {
        "status": 1,
	"number": 2,
    },
    "status": {
        "code": 1,
        "msg": "成功"
    }
}