1. part
CloudNest Open Platform API Documentation
  • Preliminary preparation
    • 0. Introduction
    • a. Use our demo to quickly generate request headers
    • b. Manually create the request header
    • 1. API Quota & API Rate Limit
    • 2. Data Dictionary
  • part
    • Generate parts (imported from nc1)
      POST
    • Generate parts (JS template)
      POST
    • Generate parts (DXF file)
      POST
    • Generate parts (SmartDraw)
      POST
    • Retrieve the full list of parts
      POST
    • Retrieve the list of parts on the layout (returned in order of their physical positions)
      POST
    • Copy parts
      POST
    • Update and delete part information
      POST
    • Update the custom properties of a part
      POST
  • plate
    • Retrieve scrap sheet hierarchy details
      GET
    • Add plate
      POST
    • Retrieve plate list
      POST
    • Update plate information
      POST
  • drawing
    • Query drawing information
      POST
    • Upload DXF drawing to the job (upload file).
      POST
    • Upload dxf drawings to the job (active download)
      POST
    • Delete DXF drawing (force delete)
      POST
    • Delete DXF drawing (cannot be deleted if processed or being processed)
      POST
  • material
    • Add Material
      POST
    • Get Material List
      GET
  • job
    • Query job information by job ID
    • Add Job
    • Get Job List
    • Get Parts List under the Job
    • Get Layout List under the Job
    • Get the formatting details of the assignment
    • Get the production schedule list of the assignment
    • Get the part layout information under the assignment
    • Get the list of plates used in the assignment
    • Get the production task details under the assignment
    • Search the assignment (exact search by assignment name)
    • Delete job
    • Query the drawing processing status under the specified job
    • Get the nesting details under the job (return the DXF download link of the nesting and the part serial numbers)
    • Boost
    • Query job information by job ID (flat view)
    • Delete nesting
  • production
    • Query completed task list for the machine tool
    • Get production task details
    • Server-side - Push the layout to the CNC machine
  • Part Text Recognition
    • Get user-defined text recognition configuration
    • Drawing processing text recognition configuration
  • others
    • Get job and material information based on the layout GUID
    • Get the parts list based on the layout GUID
  1. part

Generate parts (SmartDraw)

POST
https://mcs-gateway.fscut.com/cn-api/api/part/smartdraw
Parameter Description：
{
    "partName": "part-01", // Part name
    "material": "Cold Rolled Steel", // Part material
    "thickness": 1.0, // Part thickness
    "gas": "Air", // Gas used for the part
    "amount": 10, // Quantity of parts
    "fillColor": "800000", // Fill color of the part
    "rotateLock": 1, // Rotation lock: rotate_lock=1 locks rotation, default is 0
    "jobId": 7350, // Job ID where the part is associated
    "props": { // Part extended properties
        "Order Number": "20220330-001", // Property-value pairs
        "Material Number": "001",
        "Location.X": 8,
        "Location.Y": 10
    },
    "argument": { // SmartDraw parameters
        "L1": "50"
    }
}

Request

Authorization
Header Params

Body Params multipart/form-data

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://mcs-gateway.fscut.com/cn-api/api/part/smartdraw' \
--header 'appId: op191eb50f9b81873c' \
--header 'appSecret: appSecret' \
--header 'timestamp: 1743497261540' \
--header 'appSign: 13622d51e3e4f4935c8ba27728ed309f' \
--header 'X-FS-Orgcode: TEAM001' \
--form 'mzb_file=@"C:\\Users\\fscut\\Documents\\2022-03-29\\Mzb\\Pentagon.mzb"' \
--form 'data="{    \"partName\": \"part-01\",    \"material\": \"冷轧板\",    \"thickness\": 1.0,    \"gas\": \"Air\",    \"amount\": 10,    \"fillColor\": \"800000\",    \"rotateLock\": 1,    \"jobId\": 7350,    \"props\": {        \"订单号\": \"20220330-001\",        \"物料号\": \"001\",        \"Location.X\": 8,        \"Location.Y\": 10    },    \"argument\": {        \"L1\": \"50\"    }}"'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "status": 0,
    "msg": "OK",
    "data": {
        "guid": "669CF13C-E226-4306-A0CB-1046CA7724E4"
    }
}
Modified at 2025-04-01 09:41:41
Previous
Generate parts (DXF file)
Next
Retrieve the full list of parts
Built with