1. Preliminary preparation
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. Preliminary preparation

b. Manually create the request header

API calls are based on general request headers: app-id, time-stamp, and app-sign.
📌
If you are not familiar with the concepts mentioned above, please refer to: https://fscut-open.apifox.cn/doc-2687973
If the Friendess demo does not cover the language you use, or you want to generate the request header yourself, follow the steps below:

1 Generate appSign based on appId, appSecret, and timestamp#

First, generate a 13-digit timeStamp (the timestamp must be within ten minutes before and after the call time).
Create appSign by DIRECTLY concatenating appId , appSecret and timeStamp , then apply MD5 hashing to the whole string
image.png

2 nsert the information mentioned above into the API call request header#

{
    "app-id": "op18725d72811234d2",                // Copy the obtained appId
    "time-stamp": 1680592492719,                   // The timeStamp used when generating the appSign just nowtimeStamp
    "app-sign": "c227fc9d75471a36e3dee7bd4cc8630e" // The recently generated appSign
}
Modified at 2025-04-01 10:25:51
Previous
a. Use our demo to quickly generate request headers
Next
1. API Quota & API Rate Limit
Built with