API¶
Префикс /api/v1. Роутер собирается в backend/app/api/router.py. OpenAPI — /api/docs.
| Модуль | Префикс | Что делает сейчас |
|---|---|---|
| health | /health |
Живость и готовность |
| auth | /auth |
Регистрация, вход, код подтверждения почты, повторная отправка, refresh, logout |
| users | /users |
/users/me |
| categories | /categories |
Словарь категорий |
| candidates | /candidates |
Поиск, своё резюме, второе резюме, фото, PDF, привязка и синхронизация ФСП |
| fsp-id | /fsp-id |
Старт входа OIDC + PKCE |
| companies | /companies |
Свой профиль, логотип, публичная страница, банк задач компании |
| test-assignments | /companies/me/test-assignments |
Отправка тестового, ответы, ручная проверка |
| vacancies | /vacancies |
Список, лента, свои, карточка, реакции. Создание и правка — 501 |
| invitations | /invitations |
Все операции — 501 |
| applications | /applications |
Создание и список — 501 |
| matching | /matching |
Потребность и рекомендации — 501 |
| responses | /responses |
Входящие лайки и ответный лайк |
| calendar | /calendar |
Встречи за период, создание, перенос, отмена, подтверждение |
| conversations | /conversations |
Чаты и вложения |
| notifications | /notifications |
Лента событий |
| assessments | /assessments |
Категории, шаблоны, попытки, запуск кода, завершение, интервью, входящие тестовые. Анкета /survey — 501 |
| admin | /admin |
Пользователи, плюс пакет app/admin: банк, аналитика, работодатели, банлист, настройки, верификация |
Эмуляция FSP ID и реестра (/mock/...) подключается только при FSP_ID_MODE=mock.
Пагинация списков — page и perPage. Роль читается из базы, не только из токена.