(新)云排开放平台
  1. 零件
(新)云排开放平台
  • 前期准备
    • 0. 开发前必读
    • a.使用柏楚demo快速生成请求头
    • b.手动生成请求头
    • 1. api配额以及频率限制
    • 2. 数据字典
  • 零件
    • 生成零件(nc1导入)
      POST
    • 生成零件(JS模板)
      POST
    • 生成零件(DXF文件)
      POST
    • 生成零件(SmartDraw)
      POST
    • 获取全部零件列表
      POST
    • 获取排版上零件列表(按照零件物理位置顺序返回)
      POST
    • 复制零件
      POST
    • 更新和删除零件信息
      POST
    • 更新零件的自定义属性
      POST
  • 板材
    • 获取余料板层级详情
      GET
    • 添加板材
      POST
    • 获取板材列表
      POST
    • 更新板材信息
      POST
  • 图纸
    • 查询图纸信息
      POST
    • 上传dxf图纸到作业(上传文件)
      POST
    • 上传dxf图纸到作业(主动下载)
      POST
    • 删除dxf图纸(强制删除)
      POST
    • 删除dxf图纸(已处理/处理中的不可删除)
      POST
  • 材质
    • 添加材质
      POST
    • 获取材质列表
      GET
  • 作业
    • 根据作业id查询作业信息
    • 添加作业
    • 获取作业列表
    • 获取作业下零件列表
    • 获取作业下排版列表
    • 获取作业下排版详情
    • 获取作业下排产列表
    • 获取作业下零件排版信息
    • 获取作业下使用的板材列表
    • 获取作业下生产任务详情
    • 搜索作业(根据作业名称精确搜索)
    • 删除作业
    • 查询指定作业下图纸处理状态
    • 获取作业下排版详情(返回排版的dxf下载地址、零件序号)
    • 飞排
    • 根据作业id查询作业信息(平铺)
    • 删除排版
  • 生产
    • 查询机床完成任务列表
    • 获取生产任务详情
    • 服务端排产
  • 零件文字识别
    • 获取用户自定义文字识别配置
    • 图纸处理文字识别配置
  • 其他
    • 根据排版guid获取作业及板材信息
    • 根据排版guid获取零件列表
  1. 零件

生成零件(DXF文件)

POST
https://mcs-gateway.fscut.com/cn-api/api/part/file2part
参数说明#
[
  {
    "datas": {
      "part_name": "201109-01", // 零件名称
      "material": "冷轧板", // 零件材质
      "thickness": 1.0, // 零件厚度
      "gas": "Air", // 零件气体
      "amount": 1, // 零件数量
      "rotate_lock": 0, // 零件锁定旋转 rotate_lock=1锁定旋转,默认为0
      "fill_color": "800000", // 零件填充色
      "prop": { // 零件属性
        "订单号": "1027594022", // 属性-值
        "物料号": "277516275",
        "其他": "1"
      }
    },
    "filename": "t21.dxf", // 对应dxf文件名称
    "jobId": 1606, // 需要上传到的作业对应的id
    "optimization_parm": [
      {
        "type": "layer_map",
        "0": "process_work2",
        "_文本替换": "process_work2",
        "尺寸标注": "process_mark"
      },
      {
        "type": "optimize",
        "Smooth": {
          "ConvertCircle": true,
          "Enable": true,
          "IgnoreBezier": true,
          "Tolerance": 0.05
        }
      }
    ] // 需要自动优化参数配置的时候,可以传递该参数
  }
]
自动优化参数(optimization_parm)说明:#
自动优化处理支持的操作:
  
type = (
  "color_map", //颜色映射
  "layer_map", //图层映射
  "optimize"   //图纸优化参数
)
  
映射时处理方式的取值:
('process_work1', //加工1
'process_work2',  //加工2
'process_work3',  //加工3
'process_mark' ,  //打标
'process_nowork', //不加工
'process_delete'); //删除
  
使用图层映射时,设置type=layer_map 传参:Key为dxf的图层名称, Value为处理方式
{
    "type": "layer_map",
    "图层1": "process_work1",
    "_打标图层": "process_mark"
}
  
使用颜色映射时,设置type=color_map, 传参:Key为autoCAD的索引颜色值(1~255),参考附件表(AutoCAD索引颜色(ACI)与RGB颜色对照表), Value为处理方式
{
    "type": "color_map",
    "0": "process_nowork",
    "7": "process_work1"
}
  
使用图纸优化配置,设置type =optimize
{
    "type": "optimize",
    "RemoveTrivial": {          //去除极小图形
        "Enable": false         //是否开启,(布尔变量取值true或false,以下适用)
        "Tolerance": 0.2        //最小图形长度
    },
    "RemoveDuplication": {      //去除重复线
        "Enable": false,        //是否开启
        "Tolerance": 0.2        //重复线检测精度
    },
    "ConnectNear": {            //合并相连线
        "Enable": true,         //是否开启
        "Tolerance": 10,        //相连线检测精度
        "GapTolerance": 0.2,    //合并精度
        "First": 2              //整型,0表示方向优先,1表示长度优先,2表示距离优先
    },
    "Smooth": {                 //自动平滑
        "Enable": false,        //是否开启
        "Tolerance": 0.2,       //平滑精度
        "IgnoreBezier": false,  //不对Bezier曲线进行平滑
        "ConvertCircle": false  //自动识别DXF/DWG文件的整圆
    },
    "Unit":{                    //图纸单位
        "ImportUnit": 0         //整型,0表示公制,1表示英制,2表示读取文件单位格式
    },
    "AutoExplode":{             //自动打散
        "ExplodeText": false    //自动转换文件为曲线,
    },
    "FreezeOutLine":{           //固定零件外轮廓方向
        "FreezeOutLineStyle": 0 //整型,0表示都不启用,1表示顺时针,2表示逆时针
    }
}

使用事项 :
1、暂不支持混合映射
2、如果配置同时出现颜色映射和图层映射,取列表中的最后一种做为本次映射。
自动优化参数示例#
[
  {
    "type": "layer_map",
    "尺寸标注": "process_mark",
    "_文本替换": "process_work2",
    "0": "process_work2"
  },
  {
    "type": "optimize",
    "RemoveTrivial": {
      "Enable": true,
      "Tolerance": 0.0001
    },
    "RemoveDuplication": {
      "Enable": true,
      "Tolerance": 0.1
    },
    "ConnectNear": {
      "Enable": true,
      "Tolerance": 10,
      "GapTolerance": 0.0001,
      "First": 2
    },
    "Smooth": {
      "Enable": true,
      "Tolerance": 0.05,
      "IgnoreBezier": true,
      "ConvertCircle": true
    },
    "Unit": {
      "ImportUnit": 0
    },
    "AutoExplode": {
      "ExplodeText": false
    },
    "FreezeOutLine": {
      "FreezeOutLineStyle": 0
    }
  }
]
AutoCAD索引颜色(ACI)与RGB颜色对照表:
AutoCAD索引颜色(ACI)与RGB颜色对照表

请求参数

Header 参数

Body 参数multipart/form-data

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://mcs-gateway.fscut.com/cn-api/api/part/file2part' \
--header 'app-id: op191eb50f9b81873c' \
--header 'time-stamp: {{timeStamp}}' \
--header 'app-sign: {{sign}}' \
--header 'X-FS-Orgcode: TEAM001' \
--form 'files=@"D:\\work\\ApiPostFiles\\drawing\\test.dxf"' \
--form 'data="[    {        \"datas\":        {            \"part_name\": \"20210507-05\",            \"material\": \"304\",            \"thickness\": 0.8,            \"gas\": \"N2\",            \"amount\": 10,            \"rotate_lock\": 0,            \"fill_color\": \"800000\"        },        \"filename\": \"test.dxf\",        \"jobId\": 7036,        \"optimization_parm\":        [            {                \"type\": \"layer_map\",                \"尺寸标注\": \"process_mark\",                \"_文本替换\": \"process_work2\",                \"0\": \"process_work2\"            },            {                \"type\": \"optimize\",                \"RemoveTrivial\":                {                    \"Enable\": true,                    \"Tolerance\": 0.0001                },                \"RemoveDuplication\":                {                    \"Enable\": true,                    \"Tolerance\": 0.1                },                \"ConnectNear\":                {                    \"Enable\": true,                    \"Tolerance\": 10,                    \"GapTolerance\": 0.0001,                    \"First\": 2                },                \"Smooth\":                {                    \"Enable\": true,                    \"Tolerance\": 0.05,                    \"IgnoreBezier\": true,                    \"ConvertCircle\": true                },                \"Unit\":                {                    \"ImportUnit\": 0                },                \"AutoExplode\":                {                    \"ExplodeText\": false                },                \"FreezeOutLine\":                {                    \"FreezeOutLineStyle\": 0                }            }        ]    }]"'

返回响应

🟢200成功
application/json
Body

示例
{
    "data": [
        {
            "datas": {
                "amount": 10,
                "gas": "N2",
                "guid": "B8BACAB0-79BF-4A4F-8329-65ACC2E2BD35",
                "material": "304",
                "part_name": "20210507-05",
                "rotate_lock": 0,
                "thickness": 0.8
            },
            "filename": "test.dxf",
            "jobId": 2199,
            "optimization_parm": [
                {
                    "0": "process_work2",
                    "_文本替换": "process_work2",
                    "type": "layer_map",
                    "尺寸标注": "process_mark"
                },
                {
                    "AutoExplode": {
                        "ExplodeText": false
                    },
                    "ConnectNear": {
                        "Enable": true,
                        "First": 2,
                        "GapTolerance": 0.0001,
                        "Tolerance": 10
                    },
                    "FreezeOutLine": {
                        "FreezeOutLineStyle": 0
                    },
                    "RemoveDuplication": {
                        "Enable": true,
                        "Tolerance": 0.1
                    },
                    "RemoveTrivial": {
                        "Enable": true,
                        "Tolerance": 0.0001
                    },
                    "Smooth": {
                        "ConvertCircle": true,
                        "Enable": true,
                        "IgnoreBezier": true,
                        "Tolerance": 0.05
                    },
                    "Unit": {
                        "ImportUnit": 0
                    },
                    "type": "optimize"
                }
            ]
        }
    ],
    "msg": "OK",
    "status": 0
}
🟢200错误
修改于 2025-04-01 06:42:57
上一页
生成零件(JS模板)
下一页
生成零件(SmartDraw)
Built with