Модель платформы

Краткая карта для интегратора: что такое ядро и модуль, кто администратор, как устроена аутентификация и ответы API. ≈5–7 минут чтения.

Ядро и модуль

Ядро (сейчас 1.0.13) — основной дистрибутив: Public Auth, почта, работа с данными, шлюз, админ-панель. Модуль — отдельная поставка с собственной версией (например «Медиатека файлов» 1.0.0). Модуль подключается в админке; без него его API недоступен (404).

Кто админ, кто интегратор

Администратор — ставит платформу, настраивает SMTP, Public Auth, выпускает API-ключи, ставит модули.
Интегратор — пишет код сайта/сервиса, вызывает Public API по HTTPS, хранит секреты на сервере, не в браузере (кроме JWT пользователя).

Три режима аутентификации

Режим	Когда
Без auth	Регистрация, вход, verify email
JWT (Bearer)	Действия от имени пользователя: профиль, MFA, часть Files
X-API-Key	Backend: почта, БД, часть Files — по scope ключа

Подробнее — общие соглашения и обзор Public API.

Форматы ответа (envelope)

Большинство методов возвращают JSON с полями success, data или error. Три типичных случая:

A — успех: { "success": true, "data": { … } }
B — ошибка бизнес-логики: { "success": false, "error": { "code", "message" } }
C — HTTP 4xx/5xx с тем же телом error или стандартным сообщением

Дальше

Быстрый старт · Сценарий SPA · Установка