查询任务-QueryTaskQueues
单任务查询任务排队数量
查询除批次插入(BatchInsertTask)任务以外的其他任务插入的转换信息,转换完成后,通过该接口可以获取当前任务排队情况,获取前面还有多少个任务在排队处理。
请求方式: POST
URL地址: [YunapiUrl]/nds_requests/common/QueryTaskQueues
接口说明 |
---|
在任务插入成功,获取到taskID之后,根据taskID查询任务信息,获取任务排队情况。注意任务状态未0时,表示任务还未处理 |
字段名 | 变量名 | 必填 | 类型 | 说明 |
---|---|---|---|---|
任务ID | taskID | 是 | String | 任务ID |
字段名 | 变量名 | 必填 | 类型 | 说明 |
---|---|---|---|---|
接口状态 | status | 是 | json | 接口的调用状态,包含接口返回码和错误信息 |
接口数据 | data | 是 | json | 接口的返回数据,包含任务详细信息 |
字段名 | 属性名 | 必填 | 类型 | 说明 |
---|---|---|---|---|
返回码 | code | 是 | String | 见枚举值-code 返回码说明 |
错误信息 | msg | 是 | String | 错误信息 |
字段名 | 属性名 | 必填 | 类型 | 说明 |
---|---|---|---|---|
任务状态 | 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": "成功"
}
}