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 Job List

POST
https://mcs-gateway.fscut.com/cn-api/api/job/list
When a job is filtered, its parent node will also be returned.

filterInfo filter example:
{
    "region": "create_at", // Creation date filter
    "name": "today", // today- Today, yesterday- Yesterday, lastWeek- Last week, lastMonth- Last month, customDate- Custom date range
    "startDate": "2021-03-14", // Applies when name == 'customDate'
    "endDate": "2021-03-17" // Applies when name == 'customDate'
}

{
    "region": "status", // Status filter. If this condition is not passed, all statuses are returned by default
    "name": 0 // 0- Incomplete, 1- Completed
}

Request

Authorization
Header Params

Body Params application/json

Example
{
    "method": "string",
    "searchString": "string",
    "filterInfo": [
        {
            "region": "string",
            "name": "string",
            "startDate": "string",
            "endDate": "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/job/list' \
--header 'appId: op191eb50f9b81873c' \
--header 'appSecret: appSecret' \
--header 'timestamp: 1743497261540' \
--header 'appSign: 13622d51e3e4f4935c8ba27728ed309f' \
--header 'X-FS-Orgcode: TEAM001' \
--header 'Content-Type: application/json' \
--data '{
    "method": "string",
    "searchString": "string",
    "filterInfo": [
        {
            "region": "string",
            "name": "string",
            "startDate": "string",
            "endDate": "string"
        }
    ]
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "status": 0,
    "msg": "OK",
    "data": [
        {
            "id": 1874,
            "title": "测试",
            "parent_id": -1,
            "type": 0,
            "status": 0,
            "customer_id": null,
            "customer_name": null
        },
        {
            "id": 1872,
            "title": "20210316",
            "parent_id": -1,
            "type": 0,
            "status": 0,
            "customer_id": null,
            "customer_name": null
        },
        {
            "id": 1873,
            "title": "tmp",
            "parent_id": 1872,
            "type": 1,
            "status": 0,
            "customer_id": null,
            "customer_name": null
        }
    ]
}
Modified at 2025-04-01 09:41:41
Previous
Add Job
Next
Get Parts List under the Job
Built with