插入任务-InsertConvertFormatTask

1. 插入格式转换任务接口

格式转换任务，支持将3D或2D模型转换为其他对应格式的文件。部分格式转换需要做另外单独的部署处理。具体支持的转换格式，请参见文件格式转换。

请求方式： POST

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

Table 1. 接口说明
接口说明
添加一条格式转换任务。必须在模型文件成功上传到轻量化服务平台后，才可调用任务添加接口。建议上传的文件以“时间戳 + 随机数”命名，不含中文。

Table 2. 请求参数
字段名	变量名	必填	类型	说明
文件名	inputFiles	是	String	Minio输入文件（通过3.1接口获取临时授权路径，返回的inputNdsFile值），或者是一个http路径
文件路径类型	inputType	是	Int	0: minio 1:http路径默认0
主文件	mainFile	否	String	inputFiles为zip时，输入模型名称，如果是装配体，输入主装文件路径。输入文件为zip文件，此参数必填
任务描述	taskDescription	否	String	taskDescription为非必填，且内部参数可选填。详见枚举值-taskDescription 任务描述说明
输出格式	outputExt	是	String	转换输出格式，如：.step
回调地址	returnURL	否	String	任务处理完成后的回调处理 returnURL
2D 格式转换特定参数（仅公有云环境提供）
2D格式转换类型	formatType	否	String	2D格式转换必填，详细说明请参考附录-2D格式转换参数说明（仅公有云环境提供）
横竖版设置	rotation	否	String	1：横 2：竖不传时默认自适应
颜色设置	color	否	String	0：保留彩色 1：白底黑线 2：黑底白线
PDF质量	dpi	否	String	整数 150 ~ 100000 区间内，默认2400

Table 3. 返回参数
字段名	变量名	必填	类型	说明
接口状态	status	是	json	接口的调用状态，包含接口返回码和错误信息
接口数据	data	是	json	接口的返回数据，包含任务ID

Table 4. 变量status的属性值
字段名	属性名	必填	类型	说明
返回码	code	是	String	见枚举值-code 返回码说明
错误信息	msg	是	String	错误信息

Table 5. 变量data的属性值
字段名	属性名	必填	类型	说明
任务ID	taskID	是	String	任务ID

Table 6. 附录-2D格式转换参数说明（仅公有云环境提供）
输入文件类型	outputExt	formatType	color	dpi	rotation
.pdf	.dwg	Dwg_R14、Dwg_2000、Dwg_2004、Dwg_2007、Dwg_2010、Dwg_2013、Dwg_2018f(默认)	-	-	-
.dxf	.dwg
.dwf	.dwg
.dwg	.dwg
.dwg .dxf	.dxf	Dxf_2000、Dxf_2004、Dxf_2007、Dxf_2010、Dxf_2013、Dxf_2018f(默认)
.pdf	.dxf	Dxf_2000、Dxf_2004、Dxf_2007、Dxf_2010、Dxf_2013、Dxf_2018f(默认)
.dwg .dxf	.dwf	Dwf
	.png	P1600x1280、P1600x1200、P1280x1024、P1152x900、P1024x768(默认)、P800x600、P640x480、P1280x1600、P1200x1600、P1024x1280、P900x1152、P768x1024、P600x800、P480x640、P2479x3508、P1240x1754、P595x842、P4961x3508、P2479x1754、P1190x842、P7016x4961、P3508x2479、P1685x1190、P9922x7016、P2381x1685、P2381x168	0 彩色 1 白底黑线 2 黑底白线	-	-
	.jpg		0 彩色 1 白底黑线 2 黑底白线	-	-
	.pdf	Pdf(默认)、Pdf_A1、Pdf_A2、Pdf_A3、Pdf_A4、Pdf_B0、Pdf_B1、Pdf_B2、Pdf_B3、Pdf_B4	0(彩色) 1(白底黑线)	150-1000000的整数默认2400	1(横), 2(竖), 空（自适应）-默认

2. 示例

请求示例：

curl --location 'https://api.3dopen.cn/nds_requests/Common/InsertConvertFormatTask' \
--header 'timeStampData: 1727141578' \
--header 'partnerID: xxx' \
--header 'shaKeyData: xxxx' \
--form 'inputFiles="202409240933153300/3D.sldprt"' \
--form 'inputType="0"' \
--form 'outputExt=".step"'

返回示例：

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