Справочник

API

Платформа отдаёт REST API под /api/v1/ на том же хосте. Всё под гейтом лицензии, кроме аутентификации и служебных эндпоинтов.

Редакция от 27 июля 2026

База

Все запросы идут на ваш хост: http://<хост>:8080/api/v1/… (или через ваш reverse proxy по HTTPS). Схема и интерактивный Swagger — по /api/schema/ и /api/docs/.

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

Получите токен по логину, затем передавайте его в заголовке:

curl -X POST http://<хост>:8080/api/v1/auth/login/ \
  -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"…"}'

curl http://<хост>:8080/api/v1/projects/ \
  -H 'Authorization: Token <ваш-токен>'

Гейт лицензии

Пока хост не лицензирован, защищённые эндпоинты отвечают 402 с телом { "code": "license_required" }. Открыты без лицензии только аутентификация и служебные пути:

Эндпоинт	Назначение
`GET /api/v1/license/status/`	Статус лицензии и отпечаток хоста
`POST /api/v1/license/install/`	Активация ключа HLPR1 (только админ)
`POST /api/v1/auth/login/`	Логин, выдаёт токен

Пример: статус лицензии

curl http://<хост>:8080/api/v1/license/status/
# { "licensed": false, "fingerprint": "ac2bc19c…", "can_install": true }

Полный список ресурсов (проекты, задачи, сотрудники, сценарии, финансы, хранилище) — в интерактивной схеме /api/docs/ на вашем экземпляре.