1. plate
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. plate

Retrieve plate list

POST
https://mcs-gateway.fscut.com/cn-api/api/plate/list/v2

Request

Authorization
Header Params

Body Params application/json

Example
{
    "material_id": 0,
    "thickness": "string"
}

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/plate/list/v2' \
--header 'appId: op191eb50f9b81873c' \
--header 'appSecret: appSecret' \
--header 'timestamp: 1743497261540' \
--header 'appSign: 13622d51e3e4f4935c8ba27728ed309f' \
--header 'X-FS-Orgcode: TEAM001' \
--header 'Content-Type: application/json' \
--data '{
    "material_id": 0,
    "thickness": "string"
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
  "data": [
    {
      "id": 1271,
      "guid": "2E71B693-F7A8-4E79-A778-31EB412EBC6C",  // Plate GUID
      "material_id": 1617,  // Material ID
      "thickness": 0.8,  // Thickness
      "gap": 1,  // Plate margin (mm)
      "plate_name": "Standard Plate",  // Plate Name
      "plate_type": 0,  // Plate Type 0 - Standard, 1 - Scrap
      "remain_amount": 88,  // Remaining Quantity; if -1, indicates infinite
      "used_amount": 12,  // Used Quantity
      "width": 1200,  // Width (X)
      "height": 2000,  // Length (Y)
      "customer_id": null,  // If bound to a customer, returns customer ID
      "customer_name": null,  // If bound to a customer, returns customer name
      "dxf_name": null,  // If scrap plate, returns scrap file name
      "dxf_url": null,  // If scrap plate, returns scrap file download link
      "image_name": null,  // If scrap plate, returns thumbnail file name
      "image_url": null  // If scrap plate, returns thumbnail download link
    },
    {
      "id": 1295,
      "guid": "4EC00FC5-7DAB-4A46-8EB7-3E0734A46191",
      "material_id": 1617,
      "thickness": 0.8,
      "gap": 1,
      "plate_name": "20210306_144912_071381280Y",
      "plate_type": 1,
      "remain_amount": 10,
      "used_amount": 10,
      "width": 485,
      "height": 285,
      "customer_id": null,
      "customer_name": null,
      "dxf_name": "20210311_100459_885820757Z.dxf",
      "dxf_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/corp-plate/CorpID1001/20210311/20210311_100459_885820757Z.dxf?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1616743974&Signature=HjuWi%2BASSD4ymfdLN4TxB%2Bqqg7s%3D",
      "image_name": "20210311_100459_947927855T.png",
      "image_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/corp-plate/CorpID1001/20210311/20210311_100459_947927855T.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1616743974&Signature=rS8Grq6e8odUxguMvw9kKqU9a1E%3D"
    }
  ],
  "msg": "OK",
  "status": 0
}
Modified at 2025-04-01 09:41:41
Previous
Add plate
Next
Update plate information
Built with