Read-only доступ к вашим сохранённым проектам мебели: список проектов, метаданные, полный инженерный манифест (спецификация, материалы, фурнитура, план раскроя, производственные метаданные). Доступ по подписке Pro.
API всегда отдаёт последнее сохранённое состояние проекта — то, что вы явно сохранили кнопкой «Сохранить», а не текущее несохранённое состояние в открытом редакторе. Спецификация, раскрой и манифест пересчитываются на сервере той же самой инженерной логикой, что и в браузере — не кэш и не приблизительная копия.
Загрузка…
curl https://barsstal.com/api/v1/projects \ -H "Authorization: Bearer bsk_live_<keyId>_<secret>"
| Метод | Путь | Описание |
|---|---|---|
| GET | /api/v1/projects | Список ваших проектов мебели (метаданные, курсорная пагинация) |
| GET | /api/v1/projects/:id | Метаданные + capabilities одного проекта |
| GET | /api/v1/projects/:id/manifest | Полный инженерный Manifest v2 |
| GET | /api/v1/projects/:id/step | Точная 3D-модель проекта в формате STEP (ISO 10303-21) для CAD/CAM — см. ограничения ниже |
| GET | /api/v1/openapi.json | Машиночитаемая спецификация OpenAPI 3 |
GET /api/v1/projects/:id/step отдаёт последнее сохранённое состояние проекта как файл STEP с точными B-Rep-телами (не сетка из треугольников): каждая деталь корпуса — точный прямоугольный параллелепипед, каждый элемент каркаса стола — реальная полая профильная труба (внешний контур минус внутренний, открытые торцы). Каждый физический экземпляр детали — отдельное именованное тело (P01.1, P01.2, …), сборка в один монолит не выполняется. Геометрия строится сервером из той же канонической инженерной модели, что и Manifest v2 — не из 3D-сцены браузера.
Тип содержимого model/step, Content-Disposition: attachment; filename="BarsStal_<имя>.step". Фактическая схема файла, которую пишет ядро: AUTOMOTIVE_DESIGN (AP214) — она же возвращается в заголовке X-BarsStal-Step-Schema. Файл генерируется по запросу и нигде не хранится; отдаётся только после серверной проверки повторным импортом (число тел, габариты, объёмы).
Ограничения. В STEP попадает только авторитетная (производственная) геометрия: схематические элементы (визуальные створки шкафа-купе, схематические фронты ящиков в старых проектах, опоры/штанги) и дополнительные детали F7 без авторитетного размещения опускаются — полный перечень есть в Manifest v2. Обработка (отверстия, пазы, траектории) не включается, если она не смоделирована явно; файл — передача в CAD/CAM, а не G-код, совместимость с конкретным оборудованием зависит от вашего ПО. Лимиты: до 400 компонентов, 8 МБ на файл, 20 с на генерацию, общий лимит 60 запросов/мин; при заполненной очереди — 503 cad_unavailable с Retry-After, при таймауте — 504 cad_timeout, при превышении сложности — 422 cad_too_complex.
Путь API (/api/v1) и версия манифеста ("version": 2 внутри Manifest v2) — это два независимых контракта совместимости. Существующие поля не меняют смысл задним числом; несовместимые изменения появятся под новой версией того или другого.
Полная спецификация: /api/v1/openapi.json
BarsStal