Автоматизация раскроя на производстве: как подключить API LinearCut.RU

Когда веб-интерфейса уже недостаточно

Калькулятор на сайте отлично работает, когда данные вводятся вручную — но если у вас уже есть учётная система (1С, собственная ERP, конфигуратор на сайте), которая знает список нужных отрезков, повторный ручной ввод в веб-форму — лишний шаг и источник опечаток. Для таких случаев в LinearCut.RU есть публичный API.

Что даёт API

Публичный API v1 — это тот же самый алгоритм раскроя, что и в браузерном калькуляторе, доступный по HTTP из вашего собственного бэкенда или скрипта. Формат запроса идентичен внутреннему: список заготовок, список отрезков, настройки расчёта (толщина реза, торцовка, режим оптимизации, полезные остатки) — в ответ приходит готовая схема раскроя со статистикой использования материала.

Как получить ключ

Ключ доступен на PRO-тарифе и выпускается в личном кабинете, в разделе «API-ключи». Ключ показывается только один раз в момент создания — сохраните его сразу; если ключ утерян, отзовите его и выпустите новый.

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

curl -X POST https://linearcut.ru/api/v1/calc \
  -H "Authorization: Bearer lc_live_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "stocks": [{ "length": 6000, "quantity": null, "name": "Труба", "priority": 0 }],
    "cuts": [{ "length": 1740, "quantity": 12, "name": "Деталь" }],
    "settings": { "bladeThickness": 3, "trimEnds": 0, "optimizationMode": "balanced" }
  }'

Полное описание формата запроса и ответа, лимитов и кодов ошибок — в документации API.

Типичные сценарии использования

Интеграция с конфигуратором на сайте. Если у вас есть калькулятор стоимости изделия по индивидуальным размерам, финальный список отрезков можно сразу отправлять в API и показывать клиенту не только цену, но и реальный процент использования материала.

Пакетный пересчёт заказов из учётной системы. Вместо того чтобы вручную переносить позиции заказа в веб-калькулятор, можно написать небольшой скрипт, который забирает список отрезков из 1С или другой ERP и раз в день прогоняет их через API, сохраняя готовые схемы раскроя для цеха.

Собственный внутренний инструмент. Если у компании есть внутренняя система планирования производства, алгоритм раскроя можно встроить как один из шагов пайплайна — без необходимости поддерживать собственную реализацию оптимизации.

Важное про безопасность ключа

Ключ API — это секрет уровня пароля. Используйте его только в серверном коде; не вызывайте API напрямую из браузерного JavaScript на публичной странице — иначе любой посетитель сайта сможет увидеть ключ в сетевых запросах и использовать его от вашего имени.