1. production
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
    • Get Material List
  • 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
      POST
    • Get production task details
      POST
    • Server-side - Push the layout to the CNC machine
      POST
  • 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. production

Get production task details

POST
https://mcs-gateway.fscut.com/cn-api/api/plan/detail/v2

Request

Authorization
Header Params

Body Params application/json

Example
{
    "guid_list": [
        "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/plan/detail/v2' \
--header 'appId: op191eb50f9b81873c' \
--header 'appSecret: appSecret' \
--header 'timestamp: 1743497261540' \
--header 'appSign: 13622d51e3e4f4935c8ba27728ed309f' \
--header 'X-FS-Orgcode: TEAM001' \
--header 'Content-Type: application/json' \
--data '{
    "guid_list": [
        "string"
    ]
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "status": 0,
    "msg": "OK",
    "data": {
        "part_info": [
            {
                "guid": "CC599901-7D9C-40F3-8B1C-82E94FCE9774",
                "name": "test2-1",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "135",
                "height": "1037.3",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "136470.94",
                "out_area": "138054.91",
                "curve_length": "4011.58",
                "mark_length": "0",
                "pierce_count": 77,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_146170103B.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_146170103B.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=lbW0lQZRFUURraavc8x0D6j%2Fp5Q%3D",
                "thumbnail_path": "20221223_095525_146170103B.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_146170103B.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=hICZde1qmq0zRvYCfxc%2BzsbnBwI%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "test2-1",
                "drawing_guid": "4A7FDA15-5C7B-44A5-85D6-5C3FA913BF64"
            },
            {
                "guid": "5EC9A568-17DB-4908-BB7F-4846C5CE71C6",
                "name": "test2-5",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "135",
                "height": "1037.3",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "136470.94",
                "out_area": "138054.91",
                "curve_length": "4011.58",
                "mark_length": "0",
                "pierce_count": 77,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_153536590D.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_153536590D.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=5B3akEt9OeE5gJ%2B9Fa8LbcFWP%2F4%3D",
                "thumbnail_path": "20221223_095525_153536590D.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_153536590D.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=M9dDcILAheAl%2FPIVh40yejDxx4Y%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "test2-5",
                "drawing_guid": "ECBD1FE8-DA97-4150-B9BF-C1E0EFDB779E"
            },
            {
                "guid": "4A192F7D-02A2-48A5-A538-C65D093AB0B6",
                "name": "测试",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "113",
                "height": "85.5",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "9388.62",
                "out_area": "9661.27",
                "curve_length": "556.11",
                "mark_length": "0",
                "pierce_count": 7,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_141799248S.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_141799248S.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=5BUMRHqxlFyGLN4I%2FLRFKSmzaNc%3D",
                "thumbnail_path": "20221223_095525_141799248S.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_141799248S.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=502tZSv5TAA6wqczCOWF2YR85aM%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "测试",
                "drawing_guid": "165580E5-AFDE-4E48-BAC2-C7326D1E5384"
            },
            {
                "guid": "D8808B82-6849-425F-A6F2-C7A131C25A8C",
                "name": "test",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "113",
                "height": "85.5",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "9388.62",
                "out_area": "9661.27",
                "curve_length": "556.11",
                "mark_length": "0",
                "pierce_count": 7,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_110018146J.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_110018146J.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=g2jfEbW47o172YOU%2BMi0XZpyczY%3D",
                "thumbnail_path": "20221223_095525_110018146J.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_110018146J.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=OsiOXSCzyDKrPoNKugK414HRUUs%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "test",
                "drawing_guid": "C82C506B-7B6F-462D-9E2C-7E606768C755"
            },
            {
                "guid": "1B30E7BB-7E8B-4005-965E-BD9316FF03B6",
                "name": "test2-2",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "135",
                "height": "1037.3",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "136470.94",
                "out_area": "138054.91",
                "curve_length": "4011.58",
                "mark_length": "0",
                "pierce_count": 77,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_120427926Z.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_120427926Z.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=ZqU1Usr9MN3%2B5uFfVSkcLpAt5v8%3D",
                "thumbnail_path": "20221223_095525_120427926Z.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_120427926Z.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=ppuKZYE3VzYp2q5Wxluthjapjus%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "test2-2",
                "drawing_guid": "29525049-91E3-477E-BF0F-B68850249749"
            },
            {
                "guid": "05764248-6090-445D-97AA-444C6D43D6B1",
                "name": "test-4",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "113",
                "height": "85.5",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "9157.8",
                "out_area": "9661.27",
                "curve_length": "704.95",
                "mark_length": "0",
                "pierce_count": 11,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_125560118E.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_125560118E.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=aOKHIQoidMS5137gs58Qi01fl1E%3D",
                "thumbnail_path": "20221223_095525_125560118E.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_125560118E.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=ZCkqA%2BOgcjZzKwQwHOEAc%2FrCZoo%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "test-4",
                "drawing_guid": "E113B260-86CC-4C1E-9BE1-066E3D98ACB2"
            },
            {
                "guid": "B2880743-F757-4638-BBE3-2E5639624FFE",
                "name": "test2",
                "thickness": 1,
                "material": "冷轧板",
                "gas": "Air",
                "width": "135",
                "height": "1037.3",
                "amount": 20,
                "finish_nest_amount": 20,
                "area": "136470.94",
                "out_area": "138054.91",
                "curve_length": "4011.58",
                "mark_length": "0",
                "pierce_count": 77,
                "mark_point": 0,
                "mark_count": 0,
                "props": {
                    "prop_name": "订单号",
                    "prop_value": "F1001"
                },
                "partfile_path": "20221223_095525_140577365Z.prts",
                "partfile_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_140577365Z.prts?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=TnBiA%2BLvsNnquAZIbrdr%2Byde2Y8%3D",
                "thumbnail_path": "20221223_095525_140577365Z.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-prts/Corp-ISAMY0/20221223/20221223_095525_140577365Z.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=TfZQ22rEYah7egPrmJMY2jWX5N8%3D",
                "job_id": 30829,
                "job_title": "作业名称",
                "drawing_name": "test2",
                "drawing_guid": "9A40A419-A823-40EF-9E35-A5D7080A9CEF"
            }
        ],
        "result_info": [
            {
                "guid": "619d1697-1d26-462d-89f2-d3720114ea98",
                "result_guid": "BB822FD3-032E-4096-8C54-4531BE0C7DA8",
                "name": "2022-12-23-推送mes-1-排版2",
                "material": "冷轧板",
                "thickness": "1",
                "gas": "Air",
                "amount": 1,
                "part_amount": 109,
                "plate_guid": "3E84E3CB-FF5B-45E4-B13D-0EFF087A9DFE",
                "width": "1500",
                "height": "6000",
                "nest_x": "1495",
                "nest_y": "5969",
                "utilization": "94.6545",
                "idx": 1,
                "area": "9000000",
                "nest_area": "8834054.2877",
                "remnant_area": "0",
                "contours_count": 4933,
                "pierce_count": 4933,
                "mark_point": 0,
                "marks_count": 0,
                "curve_length": "276356.4856",
                "move_length": "257104.2535",
                "mark_length": "0",
                "total_time": "9768.3069",
                "curve_time": "4862.7323",
                "delay_time": "177.796",
                "move_time": "2067.2474",
                "pierce_time": "2660.5313",
                "plate_path": "20221223_095618_862249136A.lxds",
                "plate_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-lxds/Corp-ISAMY0/20221223/20221223_095618_862249136A.lxds?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=zSaICHf91Ln8IfMU7AjOUC1uFkU%3D",
                "thumbnail_path": "20221223_095618_862249136A.png",
                "thumbnail_url": "http://raymes.oss-cn-shanghai.aliyuncs.com/saas-resource/qa/corp-lxds/Corp-ISAMY0/20221223/20221223_095618_862249136A.png?OSSAccessKeyId=LTAIwvoiFSZhjvAB&Expires=1671847207&Signature=TwV6TM1X5fe1WrpYUTglWYCviWk%3D",
                "part_info": [
                    {
                        "amount": 18,
                        "guid": "1B30E7BB-7E8B-4005-965E-BD9316FF03B6",
                        "portion_id": "58D2CBBE-BFAE-4925-BD3D-6B6FA0F4B475",
                        "index": [
                            11,
                            17,
                            18,
                            19,
                            20,
                            28,
                            29,
                            30,
                            31,
                            33,
                            35,
                            37,
                            38,
                            39,
                            41,
                            44,
                            46,
                            48
                        ]
                    },
                    {
                        "amount": 20,
                        "guid": "5EC9A568-17DB-4908-BB7F-4846C5CE71C6",
                        "portion_id": "CC69C6D3-A4F7-4A9A-BEA9-A3C797F6A50F",
                        "index": [
                            1,
                            2,
                            3,
                            4,
                            5,
                            6,
                            7,
                            8,
                            9,
                            10,
                            12,
                            13,
                            21,
                            23,
                            24,
                            27,
                            36,
                            40,
                            54,
                            55
                        ]
                    },
                    {
                        "amount": 1,
                        "guid": "B2880743-F757-4638-BBE3-2E5639624FFE",
                        "portion_id": "648C2E0C-3357-4B5E-9711-B8CE39C8BD97",
                        "index": [
                            22
                        ]
                    },
                    {
                        "amount": 20,
                        "guid": "CC599901-7D9C-40F3-8B1C-82E94FCE9774",
                        "portion_id": "F4AE398F-C075-4FD5-8D30-4715D1BC9CAB",
                        "index": [
                            14,
                            15,
                            16,
                            25,
                            26,
                            32,
                            34,
                            42,
                            43,
                            52,
                            53,
                            56,
                            93,
                            94,
                            95,
                            105,
                            106,
                            107,
                            108,
                            109
                        ]
                    },
                    {
                        "amount": 20,
                        "guid": "4A192F7D-02A2-48A5-A538-C65D093AB0B6",
                        "portion_id": "9B5C3E18-A4D2-4BB7-B17F-1A9BB4BE2E2C",
                        "index": [
                            45,
                            47,
                            50,
                            51,
                            57,
                            58,
                            59,
                            60,
                            61,
                            62,
                            63,
                            64,
                            65,
                            66,
                            67,
                            68,
                            69,
                            70,
                            71,
                            72
                        ]
                    },
                    {
                        "amount": 10,
                        "guid": "05764248-6090-445D-97AA-444C6D43D6B1",
                        "portion_id": "5A15B6FF-7FDD-45D8-A959-82BAB1395DE2",
                        "index": [
                            49,
                            96,
                            97,
                            98,
                            99,
                            100,
                            101,
                            102,
                            103,
                            104
                        ]
                    },
                    {
                        "amount": 20,
                        "guid": "D8808B82-6849-425F-A6F2-C7A131C25A8C",
                        "portion_id": "CEB21F08-CDFD-42A3-9A8C-42988FBEC9C3",
                        "index": [
                            73,
                            74,
                            75,
                            76,
                            77,
                            78,
                            79,
                            80,
                            81,
                            82,
                            83,
                            84,
                            85,
                            86,
                            87,
                            88,
                            89,
                            90,
                            91,
                            92
                        ]
                    }
                ]
            }
        ]
    }
}
Modified at 2025-04-01 09:41:41
Previous
Query completed task list for the machine tool
Next
Server-side - Push the layout to the CNC machine
Built with