API Документация
Программный доступ к шаблонам и генератору развёрток
Базовый URL
https://packgenerator.ru/api/v1
Аутентификация
Эндпоинты генерации требуют API ключ. Получите ключ в настройках аккаунта. Доступ к API доступен на тарифах Pro и Business.
Authorization: Bearer YOUR_API_KEY
Список шаблонов доступен без авторизации.
Лимиты запросов
| Тариф | GET /templates | POST /generate |
|---|---|---|
| Pro | без ограничений | 100 запросов / день |
| Business | без ограничений | без ограничений |
При превышении лимита возвращается статус 429 Too Many Requests.
Эндпоинты
GET
/api/v1/templatesСписок всех шаблонов с метаданными
POST🔑 API ключ
/api/v1/generateГенерация развёртки по шаблону и параметрам
GET /api/v1/templates
Возвращает список всех доступных шаблонов (655+).
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
standard | string | Фильтр: FEFCO, ECMA, RIGID, ENVELOPE |
search | string | Поиск по коду или названию |
Пример запроса
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"
}| Поле | Обязательно | Описание |
|---|---|---|
templateId | ✓ | ID шаблона из списка |
parameters | ✓ | Объект с размерами в мм |
format | — | json / 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 ключи