Документация API для расчёта раскроя листовых материалов (v2)

ШиринаxВысота-Количество[-Маркировка][-КромкаСнизу;КромкаСлева;КромкаСверху;КромкаСправа]
    

Для авторизации необходимо в запросе отправлять заголовок x-api-key с ключом из личного кабинета.

Пример запроса:

curl -X POST https://dx4.ru/cut/api/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: ваш_ключ_api" \
  -d '{
    "sheetWidth": 1000,
    "sheetHeight": 2000,
    "trimming": 10,
    "kerf": 3,
    "cutType": 1,
    "allowRotation": true,
    "parts": ["300x400-2-Стенка-1;2;1;3"],
	"combineSheets": true,
	"wastes": ["800x400-2"],
    "weight": 15,
    "thickness": 16,
    "sheetCost": 1000,
    "cutCost": 10,
	"edgeCost": {"1":10,"2":20,"3":25,"4":30}
  }'
	  

Пример запроса на JavaScript:

fetch('https://dx4.ru/cut/api/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'ваш_ключ_api'
  },
  body: JSON.stringify({
    sheetWidth: 1000,
    sheetHeight: 2000,
    trimming: 10,
    kerf: 3,
    cutType: 1,
    allowRotation: true,
    parts: ["300x400-2-Стенка-1;2;1;3"],
	combineSheets: true,
	wastes: ["800x400-2"],
    weight: 15,
    thickness: 16,
    sheetCost: 1000,
    cutCost: 10,
	edgeCost: {"1":10,"2":20,"3":25,"4":30}
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Ошибка:', error));
	  

{
    "status": "success",
    "data": {
        "sheets": [
            {
                "sheetWidth": 1000,
                "sheetHeight": 2000,
                "parts": [
                    {
                        "x": 10,
                        "y": 10,
                        "w": 300,
                        "h": 400,
                        "marking": "Стенка-1",
                        "rotated": false,
                        "sizeIndex": 1,
                        "originalW": 300,
                        "originalH": 400,
                        "edgeband": [
                            "1",
                            "2",
                            "1",
                            "3"
                        ],
                        "edgebandInfo": {
                            "bottom": {
                                "type": "1",
                                "length": 300
                            },
                            "left": {
                                "type": "2",
                                "length": 400
                            },
                            "top": {
                                "type": "1",
                                "length": 300
                            },
                            "right": {
                                "type": "3",
                                "length": 400
                            }
                        }
                    },
                    {
                        "x": 313,
                        "y": 10,
                        "w": 300,
                        "h": 400,
                        "marking": "Стенка-2",
                        "rotated": false,
                        "sizeIndex": 1,
                        "originalW": 300,
                        "originalH": 400,
                        "edgeband": [
                            "1",
                            "2",
                            "1",
                            "3"
                        ],
                        "edgebandInfo": {
                            "bottom": {
                                "type": "1",
                                "length": 300
                            },
                            "left": {
                                "type": "2",
                                "length": 400
                            },
                            "top": {
                                "type": "1",
                                "length": 300
                            },
                            "right": {
                                "type": "3",
                                "length": 400
                            }
                        }
                    }
                ],
                "waste": [
                    {
                        "x": 10,
                        "y": 413,
                        "w": 980,
                        "h": 1577,
                        "area": 1545460
                    },
                    {
                        "x": 616,
                        "y": 10,
                        "w": 374,
                        "h": 400,
                        "area": 149600
                    }
                ],
                "metrics": {
                    "totalParts": 2,
                    "usedArea": 240000,
                    "wasteArea": 1695060,
                    "materialUsage": 12.402716194846672,
                    "details": {
                        "Стенка-1": {
                            "count": 1,
                            "area": 120000
                        },
                        "Стенка-2": {
                            "count": 1,
                            "area": 120000
                        }
                    }
                },
                "cutMetrics": {
                    "perimeterCuts": 5920,
                    "partCuts": 1400,
                    "totalCuts": 7320
                }
            }
        ],
        "metrics": {
            "totalSheets": 1,
            "materialUsage": 12.402716194846672,
            "totalParts": 2,
            "wasteArea": 1695060,
            "usedArea": 240000,
            "details": {
                "Стенка-1": {
                    "count": 1,
                    "area": 120000
                },
                "Стенка-2": {
                    "count": 1,
                    "area": 120000
                }
            },
            "cutMetrics": {
                "totalPerimeterCuts": 5920,
                "totalPartCuts": 1400,
                "totalTotalCuts": 7320
            },
            "totalPartsPerimeter": 2800,
            "totalPartsSideWidth": 1200,
            "totalPartsSideHeight": 1600,
            "totalSheetsWeight": 30,
            "totalPartsWeight": 3.6,
            "totalWasteWeight": 25.426,
            "totalSheetsVolume": 0.032,
            "totalPartsVolume": 0.00384,
            "totalWasteVolume": 0.027121,
            "totalSheetsMaterialCost": 2000,
            "totalCutsCost": 73.2,
            "totalPartsWithCutsCost": 2073.2,
			"totalEdgebandCost": 642,
			"guillotineCuts": 38,
			"totalPartsMaterialCost": 5640,
			"totalWasteMaterialCost": 2008.22
            "costPerM2": 8638.33,
            "costPerPart": 1036.6,
            "edgebandLength": {
                "1": 1200,
                "2": 800,
                "3": 800
            }
        }
    }
}
    

Вы можете автоматически получить DXF-файл с картой раскроя прямо через API. Для этого просто добавьте параметр "dxf": true в тело запроса.
В успешном ответе API появится ссылка data.dxf_url для скачивания файла.

Пример запроса на генерацию DXF:

{
  "sheetWidth": 1000,
  "sheetHeight": 2000,
  "trimming": 10,
  "kerf": 3,
  "cutType": 1,
  "allowRotation": true,
  "parts": ["300x400-2-Стенка-1;2;1;3"],
  "dxf": true
}

Пример ответа с DXF:

{
  "status": "success",
  "data": {
    "sheets": [...],
    "metrics": {...},
    "dxf_url": "https://dx4.ru/cut/api/dxf_results/dx4.ru_cut_20250805_124212_9408d18b.dxf"
  }
}

• Ссылка dxf_url действительна сразу после расчёта, файл можно скачать напрямую.
• Слои и структура соответствуют стандарту: детали (слой "0"), надписи ("TEXT"), размеры ("SIZES"), номера ("NUMBERS"), маркировки ("NAMES") и пр.

Вы можете автоматически получить PDF-файл с картой раскроя прямо через API. Для этого просто добавьте параметр "pdf": true в тело запроса.
В успешном ответе API появится ссылка data.pdf_url для скачивания файла.

Пример запроса на генерацию PDF:

{
  "sheetWidth": 1000,
  "sheetHeight": 2000,
  "trimming": 10,
  "kerf": 3,
  "cutType": 1,
  "allowRotation": true,
  "parts": ["300x400-2-Стенка-1;2;1;3"],
  "pdf": true
}

Пример ответа с PDF:

{
  "status": "success",
  "data": {
    "sheets": [...],
    "metrics": {...},
    "pdf_url": "https://dx4.ru/cut/api-v2/pdf_results/dx4.ru_cut_20250805_124212_9408d18b.pdf"
  }
}

• Ссылка pdf_url действительна сразу после расчёта, файл можно скачать напрямую.

{
  "status": "error",
  "error": {
    "code": 400,
    "message": "Неверный формат детали: 600x400-"
  }
}
    

Для использования API необходима действующая подписка - API доступ.
API недоступно в бесплатном режиме.

Лимиты по тарифам:

Для увеличения лимитов свяжитесь с поддержкой.