1. job
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
    • Add plate
    • Retrieve plate list
    • Update plate information
  • drawing
    • Query drawing information
    • Upload DXF drawing to the job (upload file).
    • Upload dxf drawings to the job (active download)
    • Delete DXF drawing (force delete)
    • Delete DXF drawing (cannot be deleted if processed or being processed)
  • material
    • Add Material
    • Get Material List
  • job
    • Query job information by job ID
      POST
    • Add Job
      POST
    • Get Job List
      POST
    • Get Parts List under the Job
      POST
    • Get Layout List under the Job
      POST
    • Get the formatting details of the assignment
      POST
    • Get the production schedule list of the assignment
      POST
    • Get the part layout information under the assignment
      POST
    • Get the list of plates used in the assignment
      POST
    • Get the production task details under the assignment
      POST
    • Search the assignment (exact search by assignment name)
      POST
    • Delete job
      POST
    • Query the drawing processing status under the specified job
      POST
    • Get the nesting details under the job (return the DXF download link of the nesting and the part serial numbers)
      POST
    • Boost
      POST
    • Query job information by job ID (flat view)
      POST
    • Delete nesting
      POST
  • 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. job

Get the part layout information under the assignment

POST
https://mcs-gateway.fscut.com/cn-api/api/job/part_list/v2

Request

Authorization
Header Params

Body Params application/json

Example
{
    "job_id": 0
}

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/job/part_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 '{
    "job_id": 0
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "status": 0,
    "msg": "OK",
    "data": [
        {
            "guid": "0224709E-7D0F-4E50-96A6-7066B3747ECF", // Part unique identifier
            "part_name": "Layout 002", // Part name
            "material": "Q235", // Material
            "thickness": 1.0, // Thickness
            "gas": "Air", // Gas type
            "amount": 1, // Total quantity of parts
            "width": 280.0, // Part dimensions (width)
            "height": 139.42, // Part dimensions (height)
            "job_id": 3663, // Job ID
            "job_title": "Shelf 20210915", // Job title
            "finish_nest_amount": 1, // Number of parts already nested
            "in_nest_amount": 0, // Number of parts in nesting (but not yet nested)
            "un_nest_amount": 0, // Number of parts not nested
            "finish_cut_amount": 0, // Number of parts cut
            "in_cut_amount": 0, // Number of parts being cut
            "un_cut_amount": 1, // Number of parts not cut
            "props": // Additional properties
            [
                {
                    "prop_name": "orderCode", // Property key
                    "prop_value": "2109-0011-1" // Property value
                }
            ],
            "rotate_lock": 0, // Whether rotation is locked (0 = No, 1 = Yes)
            "area": 36156.43, // Area of the part
            "weight": 29.2, // Weight of the part
            "partfile_path": "20210915_224553_749474173T.prts", // Path to part file
            "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-2F9MYT/20210915/20210915_224553_749474173T.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1636707805&Signature=r85vJ4WDT3U8oqB2njPMjwVeUus%3D", // URL to part file
            "thumbnail_path": "20210915_224553_749474173T_v2.png", // Path to thumbnail
            "thumbnail_url": "http://fc-cloudnest-prt2img.bochu.cn/prt2img/saas-resource/qa/corp-prts/Corp-2F9MYT/20210915/20210915_224553_749474173T.png?fill_color=&line_color=&outline_width=&inline_width=", // URL to thumbnail
            "drawing_name": "Drawing Name", // Corresponding drawing name
            "drawing_guid": "F4DA0D07-E654-4D94-B896-BF9D22892849", // Corresponding drawing GUID
            "plate_info": // Information about the plates the part is nested on
            [
                {
                    "guid": "15360324-AF23-41CF-B18B-4C41A90E355E", // Plate GUID
                    "part_amount": 3, // Number of parts on a single plate
                    "plate_amount": 2, // Number of plates
                    "plate_name": "Standard Plate xx" // Plate name
                },
                {
                    "guid": "15360324-AF23-41CF-B18B-4C41A90E355E",
                    "part_amount": 4,
                    "plate_amount": 1,
                    "plate_name": "Standard Plate xx"
                }
            ]
        }
    ]
}
Modified at 2025-04-01 09:41:41
Previous
Get the production schedule list of the assignment
Next
Get the list of plates used in the assignment
Built with