查询任务-QueryTaskModelFeatures

1. 查询模型特征信息接口

查询模型特征信息信息。3d任务转换成功后,通过该接口可查询对应轻量化文件模型中特征信息,面片数、孔数量、孔的id等信息。

请求方式: POST

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

Table 1. 接口说明
接口说明
在任务插入成功,获取到taskID之后,根据taskID轮询一次任务,获取任务详细信息。当返回的任务状态为  “0”(待处理)  或者  “1”(处理中)  时,继续轮询。当返回的任务状态为  “2”(处理成功)  或者  其他  时,停止轮询,根据返回结果处理业务逻辑。
Table 2. 请求参数
字段名 变量名 必填 类型 说明
任务ID taskID String 任务ID
Table 3. 返回参数
字段名 变量名 必填 类型 说明
接口状态 status json 接口的调用状态,包含接口返回码和错误信息
接口数据 data json 接口的返回数据,包含任务详细信息
变量status的属性值
返回码 code S tring 枚举值-code 返回码说明
错误信息 msg S tring 错误信息
变量data的属性值
处理状态 status int 当前任务模型特征枚举值-status 任务状态定义
特征信息路径 modelFeaturesUrl S tring 模型特征信息json文件访问url地址

2. 示例

请求示例:

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

返回示例:

{
    "data": {
        "modelFeaturesUrl": "aHR0cHM6Ly9hcGkuM2Rvc...",
        "status": 2
    },
    "status": {
        "code": 1,
        "msg": "成功"
    }
}