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

Retrieve the list of parts on the layout (returned in order of their physical positions)

POST
https://mcs-gateway.fscut.com/cn-api/api/part/loc_info
Parameter Explanation#
For Software Version 2.0:
{
  "type": "SingleResult",
  "guid": "0512478F-662C-412F-9116-2FCB5C0C94F2", // Nesting GUID
  "order_by": "x" // Sorting order for parts
}

For Software Version 1.0:
{
  "type": "task",
  "guid": "B854D234-4726-4E57-A25A-89D6D6C4020A", // Nesting task GUID
  "order_by": "x" // Sorting order for parts
}

Request

Authorization
Header Params

Body Params application/json

Example
{
    "type": "string",
    "guid": "string",
    "order_by": "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/part/loc_info' \
--header 'appId: op191eb50f9b81873c' \
--header 'appSecret: appSecret' \
--header 'timestamp: 1743497261540' \
--header 'appSign: 13622d51e3e4f4935c8ba27728ed309f' \
--header 'X-FS-Orgcode: TEAM001' \
--header 'Content-Type: application/json' \
--data '{
    "type": "string",
    "guid": "string",
    "order_by": "string"
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
// SingleResult
{
  "data": {
    "guid": "B854D234-4726-4E57-A25A-89D6D6C4020A", // Layout task guid
    "nest_result": [ // List of layout results for the task
      {
        "guid": "F25C7BFD-0B82-42F1-BAAD-6878A22C887C", // Layout guid, unique identifier
        "library_plate_guid": "2E71B693-F7A8-4E79-A778-31EB412EBC6C", // Guid for the library plate used in layout
        "part_list": [ // Parts on the layout
          "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, // Layout order
        "plate_name": "Result1" // Layout name
      },
      ...
    ],
    "task_name": "20210316-tmp-Q235-0.8-Nitrogen-0001" // Layout task name
  },
  "msg": "OK",
  "status": 0
}
Modified at 2025-04-01 09:41:41
Previous
Retrieve the full list of parts
Next
Copy parts
Built with