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

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

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

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

curl -X POST https://dx4.ru/cut/api-v3/ \
  -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-v3/', {
  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
            }
        }
    }
}
    

Параметр damages позволяет указать зоны брака на листах — области, которые алгоритм раскроя должен обходить. Детали в этих областях не размещаются. Распил пилы через зону брака разрешён — то есть зона трактуется как препятствие только для размещения деталей, а не как граница реза.

Структура поля damages:

• damages — массив правил.
• Каждое правило содержит:
  • sheets: "all" (применить ко всем листам) либо массив 1-индексированных номеров листов, например [1], [2,3].
  • zones: массив прямоугольников {"x","y","width","height"} в миллиметрах, в координатах листа от левого верхнего угла (до учёта trimming).
• Несколько правил для одного листа объединяются (зоны суммируются).
• Правило "all" применяется к каждому листу дополнительно к адресным правилам.
• Если деталь не помещается с учётом зон брака, открывается следующий чистый лист (без damages).

Пример 1. Одна зона брака на всех листах:

{
  "sheetWidth": 2500,
  "sheetHeight": 1830,
  "trimming": 10,
  "kerf": 3,
  "cutType": 3,
  "allowRotation": true,
  "parts": ["600x400-5-Полка"],
  "damages": [
    {
      "sheets": "all",
      "zones": [
        { "x": 500, "y": 300, "width": 200, "height": 150 }
      ]
    }
  ]
}

Пример 2. Адресные зоны для конкретных листов:

"damages": [
  { "sheets": [1],   "zones": [{ "x": 100, "y": 100, "width": 300, "height": 200 }] },
  { "sheets": [2,3], "zones": [{ "x": 800, "y": 50,  "width": 150, "height": 150 }] }
]

Пример 3. Комбинация "all" + адресных правил:

"damages": [
  { "sheets": "all", "zones": [{ "x": 0,   "y": 0,   "width": 100, "height": 100 }] },
  { "sheets": [2],   "zones": [{ "x": 500, "y": 500, "width": 200, "height": 200 }] }
]

Возврат в ответе

В каждом объекте листа (data.sheets[]) при использовании damages появляется поле damages — массив фактически применённых к листу зон в формате {"x","y","w","h"} (мм). Это удобно для отрисовки на фронте.

{
  "sheetWidth": 2500,
  "sheetHeight": 1830,
  "parts": [ ... ],
  "waste": [ ... ],
  "damages": [
    { "x": 500, "y": 300, "w": 200, "h": 150 }
  ],
  "metrics": { ... }
}

Совместимость

Запросы без damages работают идентично прежней версии API — поведение не меняется. При combineSheets: true листы с разными зонами брака не объединяются в один.

Вы можете автоматически получить 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-v3/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-v3/pdf_results/dx4.ru_cut_20250805_124212_9408d18b.pdf"
  }
}

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

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

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

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

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

{
  "status": "success",
  "data": {
    "sheets": [...],
    "metrics": {...},
    "svg_url": "https://dx4.ru/cut/api-v3/svg_results/dx4.ru_cut_20250805_124212_9408d18b.svg"
  }
}

• Ссылка svg_url действительна сразу после расчёта, файл можно скачать напрямую.
• Если в раскрое несколько листов — все они размещаются в одном SVG-файле друг под другом, каждый с заголовком и метриками.
• Параметр svg можно комбинировать с pdf и dxf в одном запросе — будут возвращены все три ссылки.

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

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

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

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