(新)云排开放平台
  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/list/v2
参数说明#
{
	"method": "filter",
	"searchString": "", // 名称搜索,目前支持零件名称
	"filterInfo": [ // 筛选条件
		{
			"region": "create_at", // 创建日期筛选
			"name": "customDate", // today-今天 yesterday-昨天 lastWeek-近一周 lastMonth-近一月 customDate-自行设定日期区间
			"startDate": "2020-10-01", // name == 'customDate',生效
			"endDate": "2020-10-31" // name == 'customDate',生效
		},
		{
			"region": "status", // 状态筛选
			"name": "uncompleted" // uncompleted-已排完 completed-未排完
		},
		{
			"region": "material", // 材质筛选
			"name": "冷轧板"
		},
		{
			"region": "thickness", // 厚度筛选
			"name": "1.0"
		},
		{
			"region": "gas", // 气体筛选
			"name": "Air"
		}
	],
	"job_id": [
		1870,
		1826
	], // 作业筛选,参数为作业id的列表
	"pageNum": 1, // 分页,默认第一页
	"pageSize": 100, // 分页,一页数量,默认100
	"with_prop": 0 // with_prop==1 返回零件属性
}

请求参数

Header 参数

Body 参数application/json

示例
{
    "method": "string",
    "searchString": "string",
    "filterInfo": [
        {
            "region": "string",
            "name": "string",
            "startDate": "string",
            "endDate": "string"
        }
    ],
    "job_id": [
        0
    ],
    "pageNum": 0,
    "pageSize": 0
}

示例代码

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/list/v2' \
--header 'app-id: op191eb50f9b81873c' \
--header 'time-stamp: {{timeStamp}}' \
--header 'app-sign: {{sign}}' \
--header 'X-FS-Orgcode: TEAM001' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "string",
    "searchString": "string",
    "filterInfo": [
        {
            "region": "string",
            "name": "string",
            "startDate": "string",
            "endDate": "string"
        }
    ],
    "job_id": [
        0
    ],
    "pageNum": 0,
    "pageSize": 0
}'

返回响应

🟢200成功
application/json
Body

示例
{
  "data": [
    {
      // 零件唯一标识符
      "guid": "90FD531C-4B1A-48D1-B777-2FD404970363",
      // 零件名称
      "part_name": "(切割图454)65EA3bC3",
      // 材质
      "material": "Q235",
      // 厚度
      "thickness": 0.8,
      // 气体
      "gas": "N2",
      // 数量
      "amount": 10,
      // 在排数量
      "in_nest_amount": 0,
      // 未排数量
      "un_nest_amount": 10,
      // 已排数量
      "finish_nest_amount": 0,
      // 在加工数量
      "in_cut_amount": 0,
      // 待加工数量
      "un_cut_amount": 0,
      // 已加工数量
      "finish_cut_amount": 0,
      // 尺寸-宽
      "width": 670,
      // 尺寸-高
      "height": 437,
      // 所在作业id
      "job_id": 1870,
      // 所在作业名称
      "job_title": "02",
      // 零件文件名称
      "partfile_path": "20210315_153103_784946823J.prts",
      // 零件下载链接
      "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/corp-prts/CorpID1001/20210315/20210315_153103_784946823J.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1615888553&Signature=uib0Sh9U0z2H76mPQyUyZUWSgP4%3D",
      // 缩略图文件名称
      "thumbnail_path": "20210315_153103_784946823J.png",
      // 缩略图下载链接
      "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/corp-prts/CorpID1001/20210315/20210315_153103_784946823J.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1615888553&Signature=ewVKvmpCtQ5LTXg7jZqAft0ST1g%3D",
      "create_by": 1670,
      "update_by": null
    }
  ],
  "msg": "OK",
  "page_num": 1,
  "page_size": 100,
  "status": 0,
  "total": 84
}
修改于 2025-04-01 06:42:57
上一页
生成零件(SmartDraw)
下一页
获取排版上零件列表(按照零件物理位置顺序返回)
Built with