Public API — Сводный индекс endpoint'ов
Версия: 1.0.9 | Обновлено: 2026-08-21
Только API ядра. Endpoint'ы сторонних плагинов — через OpenAPI discovery или документацию поставщика.
Public Auth — /api/v1/auth
| Method | Path | Auth |
|---|
| POST | /api/v1/auth/register | None |
| POST | /api/v1/auth/login | None |
| POST | /api/v1/auth/email/verify | None |
| GET | /api/v1/auth/me | JWT (тип «public») |
| PATCH | /api/v1/auth/me | JWT (тип «public») |
| PATCH | /api/v1/auth/me/password | JWT (тип «public») |
| POST | /api/v1/auth/token/refresh | токен обновления in body |
| POST | /api/v1/auth/logout | JWT + optional refresh |
| POST | /api/v1/auth/mfa/setup | JWT (тип «public») |
| POST | /api/v1/auth/mfa/enable | JWT (тип «public») |
| POST | /api/v1/auth/mfa/disable | JWT (тип «public») |
Mail Service — /api/v1/mail
| Method | Path | Auth |
|---|
| POST | /api/v1/mail/send | X-API-Key (mail:send) |
| GET | /api/v1/mail/jobs/{job_id} | X-API-Key (mail:send) |
Database Service — /api/v1/db
| Method | Path | Auth |
|---|
| POST | /api/v1/db/query | X-API-Key (db:query) |
| POST | /api/v1/db/transaction/begin | X-API-Key (db:query) |
| POST | /api/v1/db/transaction/{id}/commit | X-API-Key (db:query) |
| POST | /api/v1/db/transaction/{id}/rollback | X-API-Key (db:query) |
| GET | /api/v1/db/transaction/list | X-API-Key (db:query) |
| GET | /api/v1/db/datasources | X-API-Key (db:query) |
Files Service — /api/v1/files
| Method | Path | Auth |
|---|
| POST | /api/v1/files/upload | JWT access или X-API-Key (files:upload) |
| GET | /api/v1/files/{file_id}/download | JWT или X-API-Key (files:download) |
| GET | /api/v1/files/{file_id} | JWT или X-API-Key |
Plugin Public API — контракт ядра
Конкретные адреса методов расширений зависят от установленных модулей. Общий принцип — в разделе API расширений; актуальный список — в GET /api/openapi.json.
| Method | Path pattern | Auth |
|---|
| * | /api/module/{plugin_name}/{path} | определяет плагин |
Discovery: GET /api/openapi.json → filter tag = {plugin_name}.
Module proxy — /api/module/{module}
Прокси к отдельно собираемым модулям (modules/). Контракт определяет модуль.
| Method | Path | Auth |
|---|
| * | /api/module/{module}/{path} | per-module |
| Method | Path | Auth |
|---|
| GET | /api/openapi.json | None |
| GET | /api/docs/public | None |
| GET | /metrics | None |
