查询任务-QueryTaskModelInfo

1. 单任务查询接口

查询除批次插入(BatchInsertTask)任务以外的其他任务插入的转换信息,转换完成后,通过该接口可以查询3D模型详细信息。返回结构信息、PMI信息、属性信息 的url访问地址,仅本地私有化 部署提供,需要手动开放配置,设置“NeedDataAnalysis”为1。

请求方式: POST

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

Table 1. 接口说明
接口说明
在任务插入成功,获取到taskID之后,根据yunapi服务配置”NeedDataAnalysis”,是否处理轻量化模型解析 (值为1时会处理,默认不处理),获取模型结构,PMI,属性信息等,并保存为对应json文件到轻量化预览地址中。信息保存成功后,调用该接口返回获取的信息的json文件url访问地址数组。
Table 2. 请求参数
字段名 变量名 必填 类型 说明
任务ID taskID String 任务ID
Table 3. 返回参数
字段名 变量名 必填 类型 说明
接口状态 status json 接口的调用状态,包含接口返回码和错误信息
接口数据 data json 接口的返回数据,包含任务详细信息
Table 4. 变量status的属性值
字段名 属性名 必填 类型 说明
返回码 code String 枚举值-code 返回码说明
错误信息 msg String 错误信息
Table 5. 变量data的属性值(数组结构)
字段名 属性名 必填 类型 说明
结构信息路径 modelInfoURL String 模型信息json文件访问url地址
PMI信息路径 pmiInfoURL String Pmi信息json文件访问url地址
属性信息路径 propertyInfoURL String 属性信息json文件访问url地址

2. 示例

请求示例:

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

返回示例:

{
    "data": {
        "modelInfoURL": "aHR0cHM6Ly9hcGkuM2Rvc...",
        "pmiInfoURL": "aHR0cHM6Ly9taW5pb2Fja...",
        "propertyInfoURL": "aHR0cHM6Ly9taW5pb2Fja..."
    },
    "status": {
        "code": 1,
        "msg": "成功"
    }
}