# Вход и сессии

Вход по ссылке из бота, Telegram Login, Mini App и паролю; сессии кабинета и выход.

| Метод | Путь | Доступ | Scope | Назначение |
| --- | --- | --- | --- | --- |
| `POST` | [`/api/v1/auth/link/inspect`](/docs/api/auth/auth-link-inspect) | Без авторизации | – | Проверить, в чей кабинет ведёт одноразовая ссылка из бота |
| `POST` | [`/api/v1/auth/link/redeem`](/docs/api/auth/auth-link-redeem) | Без авторизации | – | Однократно обменять ссылку из бота на web-сессию |
| `POST` | [`/api/v1/auth/oidc/start`](/docs/api/auth/auth-oidc-start) | Без авторизации | – | Начать Telegram Login OIDC: URL авторизации и cookie состояния на 10 минут |
| `POST` | [`/api/v1/auth/oidc`](/docs/api/auth/auth-oidc) | Без авторизации | – | Завершить Telegram Login по code и state |
| `POST` | [`/api/v1/auth/tma`](/docs/api/auth/auth-tma) | Без авторизации | – | Проверить подписанную строку Telegram.WebApp.initData и выдать TMA bearer и профиль |
| `POST` | [`/api/v1/auth/tma/refresh`](/docs/api/auth/auth-tma-refresh) | Mini App (TMA) | – | Продлить тот же TMA token: sliding expiry 15 минут, абсолютный срок не более 12 часов |
| `POST` | [`/api/v1/auth/logout`](/docs/api/auth/auth-logout) | Cookie кабинета · Mini App (TMA) | – | Отозвать предъявленную web-сессию или TMA token и остановить связанные активные операции |
| `GET` | [`/api/v1/auth/sessions`](/docs/api/auth/auth-sessions) | Cookie кабинета | – | Список действующих web- и TMA-сессий студента |
| `POST` | [`/api/v1/auth/sessions/revoke-all`](/docs/api/auth/auth-sessions-revoke-all) | Cookie кабинета | – | Отозвать все сессии и TMA tokens студента, включая текущую |
| `POST` | [`/api/v1/auth/password/login`](/docs/api/auth/auth-password-login) | Без авторизации | – | Войти по email и паролю |
| `POST` | [`/api/v1/auth/password/forgot`](/docs/api/auth/auth-password-forgot) | Без авторизации | – | Запросить письмо со ссылкой сброса пароля (30 минут) |
| `POST` | [`/api/v1/auth/password/reset`](/docs/api/auth/auth-password-reset) | Без авторизации | – | Однократно использовать токен письма: задать пароль, погасить ссылки и отозвать все сессии |
| `GET` | [`/api/v1/auth/password`](/docs/api/auth/auth-password-status) | Cookie кабинета · Mini App (TMA) | – | Прочитать статус пароля и почты |
| `POST` | [`/api/v1/auth/password/setup`](/docs/api/auth/auth-password-setup) | Cookie кабинета · Mini App (TMA) | – | Запросить письмо установки/смены email |
| `POST` | [`/api/v1/auth/password/change`](/docs/api/auth/auth-password-change) | Cookie кабинета · Mini App (TMA) | – | Проверить текущий пароль и заменить его |
