Meta & Observability API

Endpoint'ы для получения machine-readable spec и метрик. Не требуют аутентификации.

---

GET /api/openapi.json

Публичная OpenAPI 3.x спецификация.

Auth: None

Content-Type: application/json

Scope (включённые path prefixes):

PrefixСодержание
/v1/auth/*Public Auth (ядро)
/v1/db/*Database Service (ядро)
/module/*Plugin public routes (динамически, при старте плагинов)

Mail и Files могут отсутствовать в auto-generated spec — см. api-mail.html, api-files.html. Routes сторонних плагинов появляются в spec после их загрузки.

---

GET /api/docs/public

Read-only Swagger UI для public API.

Auth: None

Content-Type: text/html

Spec URL: /api/openapi.json (локальные assets, без CDN)

---

GET /metrics

Prometheus metrics export.

Auth: None

Content-Type: text/plain; version=0.0.4; charset=utf-8

В production рекомендуется ограничить доступ к /metrics на уровне reverse proxy / network policy.

---