API: вход, пользователи и роли

Главная / Документация / APIAPI: вход, пользователи и ролиВход, пользователи и роли: полный перечень из 48 методов с параметрами и схемами тел.Обновлено 23.06.2026Все пути приведены без общего префикса `/api/v1`. Детальные схемы тел запросов и ответов доступны в интерактивной документации (`/api/docs` при включенном `EXPOSE_API_DOCS`); ниже - метод, путь, требуемое право и назначение.Аутентификация (`/auth`)

Метод

Путь

Право

Назначение

POST

`/auth/login`

публичный, лимит 5/мин

Вход, выдача access-токена (refresh - в cookie)

POST

`/auth/refresh`

по refresh-cookie

Обновление access-токена

POST

`/auth/logout`

сессия

Выход

GET

`/auth/me`

сессия

Текущий пользователь

POST

`/auth/change-password`

сессия

Смена своего пароля

POST

`/auth/forgot-password`

публичный, лимит 3/мин

Запрос ссылки сброса пароля

POST

`/auth/reset-password`

по токену сброса

Установка нового пароля по ссылке

Учетные записи (`/users`)

Метод

Путь

Право

GET

`/users`

`users.read`

POST

`/users`

`users.create`

GET

`/users/{user_id}`

`users.read`

PUT

`/users/{user_id}`

`users.update`

POST

`/users/{user_id}/block`

`users.block`

POST

`/users/{user_id}/unblock`

`users.unblock`

POST

`/users/{user_id}/reset-password`

`users.reset_password`

POST

`/users/{user_id}/send-password-reset`

`users.send_password_reset`

POST

`/users/{user_id}/reset-2fa`

`users.reset_2fa`

PUT

`/users/{user_id}/roles`

`users.update_roles`

Сотрудники (`/people`)

Метод

Путь

Право

GET

`/people`

`employees.read`

GET

`/people/{person_id}`

`employees.read`

POST

`/people`

`employees.create`

PUT

`/people/{person_id}`

`employees.update`

PUT

`/people/{person_id}/roles`

`employees.update`

Роли (`/admin/roles`, `/roles`)

Метод

Путь

Право

GET

`/roles/list`

сессия (для форм)

GET

`/admin/roles/catalog`

`roles.read`

GET

`/admin/roles`

`roles.read`

GET

`/admin/roles/{role_id}`

`roles.read`

POST

`/admin/roles`

`roles.create`

PUT

`/admin/roles/{role_id}`

`roles.update`

DELETE

`/admin/roles/{role_id}`

`roles.delete`

PUT

`/admin/roles/{role_id}/permissions`

`roles.update`

См. также: `dev-auth` (аутентификация), `admin-roles` (модель прав), `guide-users` (пользовательское описание).

Интеграции и REST API

Функциональная карта