Внутренний /api/v1 — наши оболочки (Web App,
Admin Panel).
Внешний /public/v1 — курируемый срез того
же движка (Public API).
Конкретный контракт — в tests.html владельца.
| Семья ресурсов | Ярус | Владелец |
|---|---|---|
| session · users · api-keys · invites · messenger-link · password · audit | /api/v1 | Auth / Security |
conversations · messages (SSE) · chat-models |
/api/v1 | Query Engine |
| agents · agent-runs | /api/v1 | Agent Engine |
| retrieval: vector · lexical · graph · sql · hybrid | /api/v1 | Knowledge Store |
| KS-admin: sources · reindex · re-embed · backup · restore | /api/v1 | Knowledge Store |
| sources · connectors · sync-runs · test-connection | /api/v1 | Harvester |
| ai: providers · models · assignments · tools · discovery | /api/v1 | AI Foundation |
inbox · feed · unread (личные) |
/api/v1 | Notifications |
| конфиг: platform-settings · ai-prompt · usage/budgets · каналы | /api/v1 | Admin Panel · фасад |
slack: events (вебхук) · admin/slack |
/api/v1 | Slack |
| telegram: webhook · admin/telegram | /api/v1 | Telegram |
admin/mattermost (без вебхука — исходящий слушатель) |
/api/v1 | Mattermost |
| search · ask v2 | /public/v1 | Public API |
search_knowledge (JSON-RPC, streamable HTTP) |
/mcp | MCP |
events: stream (SSE · push-сигналы) |
/api/v1 | этот слой · Живые обновления |
| health · version | — | инфраслой · backend/api/ |
Admin Panel и Web App — фасады: своих доменных
ресурсов не держат, сводят контракты владельцев под ролью. Строка Admin —
про конфиг-поверхность /admin/*, не про владение.
/api/v1 · /public/v1; ломающее → новая версияach_… → user_id → роль → ACL401 · 403 · 404 · 409 · 422 · 429, единая формаSSE: токены инкрементами, цитаты в хвостеjob_id: повтор не задваивает429 (Cache & Workers)…Z); пояс применяет фронтСобственная механика слоя: платформенный push-канал, который держит живые борды свежими, и conformance-набор, исполняющий правила выше — форма ошибки, UTC, пагинация и лимит частоты проверяются параметрически по всем роутерам, а не копией в каждом модуле.