API Документация

Программный доступ к шаблонам и генератору развёрток

Базовый URL

https://packgenerator.ru/api/v1

Аутентификация

Эндпоинты генерации требуют API ключ. Получите ключ в настройках аккаунта. Доступ к API доступен на тарифах Pro и Business.

Authorization: Bearer YOUR_API_KEY

Список шаблонов доступен без авторизации.

Лимиты запросов

ТарифGET /templatesPOST /generate
Proбез ограничений100 запросов / день
Businessбез ограниченийбез ограничений

При превышении лимита возвращается статус 429 Too Many Requests.

Эндпоинты

GET
/api/v1/templates

Список всех шаблонов с метаданными

POST
/api/v1/generate

Генерация развёртки по шаблону и параметрам

🔑 API ключ

GET /api/v1/templates

Возвращает список всех доступных шаблонов (655+).

Параметры запроса

ПараметрТипОписание
standardstringФильтр: FEFCO, ECMA, RIGID, ENVELOPE
searchstringПоиск по коду или названию

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

curl https://packgenerator.ru/api/v1/templates?standard=FEFCO

Пример ответа

{
  "count": 261,
  "templates": [
    {
      "id": "fefco-0201",
      "code": "FEFCO 0201",
      "standard": "FEFCO",
      "nameRu": "Коробка с клапанами",
      "parameters": [
        { "key": "L", "labelRu": "Длина", "unit": "mm", "min": 10, "max": 2000, "defaultValue": 200 },
        { "key": "W", "labelRu": "Ширина", "unit": "mm", "min": 10, "max": 2000, "defaultValue": 150 },
        { "key": "H", "labelRu": "Высота", "unit": "mm", "min": 10, "max": 2000, "defaultValue": 100 }
      ]
    }
  ]
}

POST /api/v1/generate

Генерирует развёртку и возвращает её в формате JSON, SVG или DXF.

Тело запроса

{
  "templateId": "fefco-0201",
  "parameters": {
    "L": 300,
    "W": 200,
    "H": 150
  },
  "options": {
    "showDimensions": true
  },
  "format": "json"
}
ПолеОбязательноОписание
templateIdID шаблона из списка
parametersОбъект с размерами в мм
formatjson / svg / dxf (по умолчанию json)
options.showDimensionsВключить размерные аннотации (default: true)

Пример — скачать SVG

curl -X POST https://packgenerator.ru/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"fefco-0201","parameters":{"L":300,"W":200,"H":150},"format":"svg"}' \
  -o dieline.svg

Коды ошибок

КодОписание
200Успех
400Неверные параметры
401Отсутствует или неверный API ключ
404Шаблон не найден
500Ошибка генерации
Получить API ключ: Настройки → API ключи