Краткая карта для интегратора: что такое ядро и модуль, кто администратор, как устроена аутентификация и ответы API. ≈5–7 минут чтения.
Ядро (сейчас 1.0.15) — основной дистрибутив: Public Auth, почта, работа с данными, шлюз, админ-панель, лицензия license.cascad, маркет расширений (bundled). Плагинам с собственной БД настройка выполняется в админке (как для backend-сервисов), без отдельного DSN в конфиге. Модуль — отдельная поставка с собственной версией (например «Медиатека файлов» 1.0.1). Модуль подключается в админке; без него его API недоступен (404).
| Режим | Когда |
|---|---|
| Без auth | Регистрация, вход, verify email |
| JWT (Bearer) | Действия от имени пользователя: профиль, MFA, часть Files |
| X-API-Key | Backend: почта, БД, часть Files — по scope ключа |
Подробнее — общие соглашения и обзор Public API.
Большинство методов возвращают JSON с полями success, data или error. Три типичных случая:
{ "success": true, "data": { … } }{ "success": false, "error": { "code", "message" } }