API调用说明

API基础信息

基础URL https://www.veezy.cn
认证方式 Bearer Token (在Authorization头中)
Content-Type application/json

认证说明

所有API调用需要在请求头中包含Authorization字段：

Authorization: Bearer YOUR_API_KEY

获取API密钥请前往 账户设置。

转换API

POST /api/convert/start-convert 开始转换文件
请求参数
参数名 类型 必填 说明
sourceFormat string 是 源文件格式（如：.dwg, .dxf, .step等）
targetFormat string 是 目标文件格式（如：.pdf, .step, .stl等）
url string 是 待转换的文件链接,必须可访问,如:https://www.example.com/file.dwg
支持的源文件格式
AutoCAD 格式
  • .dwg - AutoCAD DWG
  • .dxf - AutoCAD DXF
CATIA 格式
  • .model - CATIA V4
  • .catpart - CATIA V5
  • .3dxml - CATIA V6
Creo/ProE 格式
  • .prt - Creo Parametric
  • .xpr - Creo Parametric
SOLIDWORKS 格式
  • .sldprt - SOLIDWORKS
Inventor 格式
  • .ipt - Inventor
NX 格式
  • .prt - NX
Solid Edge 格式
  • .par - Solid Edge
通用 3D 格式
  • .step/.stp - STEP
  • .stl - STL
  • .obj - OBJ
  • .fbx - FBX
  • .3ds - 3DS
  • .dae - COLLADA
  • .gltf/.glb - glTF
  • .igs/.iges - IGES
  • .x_t/.x_b - Parasolid
  • .3dm - Rhino
  • .jt - JT
  • .ifc - IFC
  • .u3d - Universal 3D
支持的目标文件格式
文档格式
  • .pdf - PDF
3D 格式
  • .step/.stp - STEP
请求示例
# AutoCAD DWG 转 PDF
curl -X POST https://api.veezy.com/api/convert/start-convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "SourceFormat=.dwg" \
  -F "TargetFormat=.pdf" \
  -F "url=https://www.example.com/file.dwg"
响应示例
{
  "taskId": "task-12345-abcde"
}

查询转换状态

GET /api/convert/get-convert-task 查询转换任务状态
查询参数
参数名 类型 必填 说明
taskId string 是 转换任务ID
请求示例
curl -X GET "https://api.veezy.com/api/convert/get-convert-task?taskId=task-12345-abcde" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "id": "task-12345-abcde",
  "resultFileUrl": "https://www.example.com/file.pdf",
  "convertStatus": "Completed"
}
转换状态说明
  • Waiting - 等待转换
  • Processing - 转换中
  • Completed - 转换完成
  • Failed - 转换失败

错误码说明

错误码 说明
200 成功
400 请求参数错误
401 认证失败
403 权限不足
404 资源不存在
429 请求频率超限
500 服务器内部错误
注意事项
  • 所有API请求请使用HTTPS协议
  • 每次转换消耗1个积分，请确保账户有足够积分
  • 单次上传文件最大支持20MB
  • 转换任务最长保留时间为24小时，请及时下载结果
  • 如有任何疑问，请联系客服