查询任务-QueryBatchTask

1. 批次查询接口

查询批次插入（BatchInsertTask）的转换信息，转换完成后，通过该接口可以获取批次转换拆分后的子任务列表数据。

请求方式： POST

URL地址：  [YunapiUrl]/nds_requests/common/QueryBatchTask

Table 1. 接口说明
接口说明
在批次转换任务插入成功，获取到batchNO之后，根据batchNO轮询一次任务，获取任务详细信息。当返回的任务状态为  “0”（待处理）  或者  “1”（处理中）  时，继续轮询。当返回的任务状态为  “2”（处理成功）  或者  其他  时，停止轮询，根据返回结果处理业务逻辑。
Table 2. 请求参数
字段名 变量名 必填 类型 说明
任务批次号 batchNO 是 String 调用多任务批量添加接口后获取
Table 3. 返回参数
字段名 变量名 必填 类型 说明
接口状态 status 是 json 接口的调用状态，包含接口返回码和错误信息
接口数据 data 是 json 接口的返回数据，包含任务详细信息
Table 4. 变量status的属性值
字段名 属性名 必填 类型 说明
返回码 code 是 String 见枚举值-code 返回码说明
错误信息 msg 是 String 错误信息
Table 5. 变量data的属性值
字段名 属性名 必填 类型 说明
任务状态 status 是 String 任务状态，见枚举值-status 任务状态定义
错误描述 errorDescription 是 String 错误描述
错误详细信息 errorDetail 否 String 错误详细信息
任务类型 taskType 是 Int 见任务类型定义
服务版本号 version 否 String 转换服务版本号
转换错误类型 errorType 否 Int 见枚举值-errorType 错误信息描述
子任务信息 childList 否 List 子任务信息，数组中对应定义见变量 childList 的对象属性值
Table 6. 变量 childList 的对象属性值
字段名 属性名 必填 类型 说明
子任务ID taskID 是 Int 任务ID，可通过任务查询接口单独查询该任务状态
文件路径 filePath 是 String 文件在上传的压缩包中的相对路径，如 文件夹1/ LM40UU.SLDPRT
任务状态 status 是 String 任务状态，见枚举值-status 任务状态定义
错误描述 errorDescription 是 String 错误描述
错误详细信息 errorDetail 否 String 错误详细信息
输出文件路径 outputFiles 否 String 输出文件FTP路径
NdsFile-输出路径 outputNdsFiles 否 String 输出文件临时下载路径，通过base64编码
转换错误类型 errorType 否 Int 见枚举值-errorType 错误信息描述

2. 示例

请求示例：

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

返回示例：

{
    "data": {
        "status": 2,
        "errorDescription": "",
        "errorDetail": "",
        "errorType": 0,
        "childList": [{
                "status": 2,
                "taskId": 2,
                "filePath": "2D.dxf",
                "errorType": 0,
                "outFilePathType": 4,
                "outputNdsFiles": "aHR0cHM6Ly9taW5pb2Fjay4zZG9...",
                "outputLightData": "aHR0cHM6Ly9taW5pb2Fjay4zZG9..."
            }, {
                "status": 2,
                "taskId": 3,
                "filePath": "3D.sldprt",
                "errorType": 0,
                "outFilePathType": 4,
                "outputNdsFiles": "aHR0cHM6Ly9taW5pb2Fjay4zZG9..",
                "outputLightData": "aHR0cHM6Ly9taW5pb2Fjay4zZG9..."
            }
        ]
    },
    "status": {
        "code": 1,
        "msg": "成功"
    }
}