API авторизации пользователей — `/api/v1/auth`

Модель аутентификации: JWT с audience public для protected routes

Формат ответа: формат ответа A (см. общие соглашения)

Полный контракт: Swagger UI (/api/docs/public), сводный индекс, GET /api/openapi.json.

На каждой странице метода ниже — пример JSON запроса/ответа и curl. Как читать страницы — соглашения § страница метода.

JWT

Access token: Authorization: Bearer <token>, audience=public
Refresh token: передаётся в body для /token/refresh и опционально в /logout
Token type: Bearer, поле expires_in — секунды до истечения access token

Методы API