(新)云排开放平台
  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. 零件

获取排版上零件列表(按照零件物理位置顺序返回)

POST
https://mcs-gateway.fscut.com/cn-api/api/part/loc_info
参数说明#
2.0版本软件使用
{
	"type": "SingleResult",
	"guid": "0512478F-662C-412F-9116-2FCB5C0C94F2", // 排版guid
	"order_by": "x" // 零件的返回顺序
}

1.0版本软件使用
{
	"type": "task",
	"guid": "B854D234-4726-4E57-A25A-89D6D6C4020A", // 排样任务的guid
	"order_by": "x" // 零件的返回顺序
}

请求参数

Header 参数

Body 参数application/json

示例
{
    "type": "string",
    "guid": "string",
    "order_by": "string"
}

示例代码

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/loc_info' \
--header 'app-id: op191eb50f9b81873c' \
--header 'time-stamp: {{timeStamp}}' \
--header 'app-sign: {{sign}}' \
--header 'X-FS-Orgcode: TEAM001' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "string",
    "guid": "string",
    "order_by": "string"
}'

返回响应

🟢200成功
application/json
Body

示例
// SingleResult
{
    "status": 0,
    "msg": "OK",
    "data": {
        "guid": "0512478F-662C-412F-9116-2FCB5C0C94F2", // 排版guid
        "result_name": "[排版1] 023040.8氮气2", // 排版名称
        "library_plate_guid": "3DBFD92B-9BB7-4F52-95AF-A6FCD6C678EC", // 排版使用的板材库板材的guid
        "part_list": [ // 排版上的零件
            "45574BE5-1B74-46D9-BE17-A204AAC374DE",
            "3490DA91-A87C-41E3-95E4-A5A318DE69FE",
            "6A08ABE8-D7E0-4BD8-9D9C-B8828B5806B1",
            "6A08ABE8-D7E0-4BD8-9D9C-B8828B5806B1",
            "6A08ABE8-D7E0-4BD8-9D9C-B8828B5806B1",
            "D5721555-5816-4054-B385-4B63C13CC18F",
            "3490DA91-A87C-41E3-95E4-A5A318DE69FE",
            "D5721555-5816-4054-B385-4B63C13CC18F",
            "D5721555-5816-4054-B385-4B63C13CC18F",
            "D7325C30-C1D3-4942-9107-BA0D0BE645D6"
        ]
    }
}

// task
{
  "data": {
    "guid": "B854D234-4726-4E57-A25A-89D6D6C4020A", // 排样任务的guid
    "nest_result": [ // 排样任务的排版结果列表
      {
        "guid": "F25C7BFD-0B82-42F1-BAAD-6878A22C887C", // 排版的guid,唯一标识符
        "library_plate_guid": "2E71B693-F7A8-4E79-A778-31EB412EBC6C", // 排版使用的板材库板材的guid
        "part_list": [ // 排版上的零件
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "18333808-2CD6-4F67-BC11-CDDE1477CCCA",
          "A12FCFF2-2DBA-45C3-BDE2-770578A31842",
          "2C665B5D-A0D8-44D4-AF77-A7B59170ED25",
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "18333808-2CD6-4F67-BC11-CDDE1477CCCA",
          "EB779B6E-8255-4FC3-820E-CF6631DC8A17",
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "EB779B6E-8255-4FC3-820E-CF6631DC8A17",
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "83F4AFD1-B373-4C03-952E-A2B194EBB7E0",
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "017FE518-9C53-41BB-9566-54AEBAADAA16",
          "017FE518-9C53-41BB-9566-54AEBAADAA16"
        ],
        "plate_idx": 1, // 排版的顺序
        "plate_name": "Result1" // 排版的名称
      },
      ...
    ],
    "task_name": "20210316-tmp-Q235-0.8-氮气-0001" // 排样任务名称
  },
  "msg": "OK",
  "status": 0
}
修改于 2025-04-01 06:42:57
上一页
获取全部零件列表
下一页
复制零件
Built with