2.5 KiB
description
| description |
|---|
| Controller for managing token refresh operations, allowing users to refresh their access tokens using a valid refresh token. |
Обновление токенов
POST /api/auth/token/refresh
Доступ анонимный. JSON:
{"refreshToken":"<последний сохранённый refresh token>"}
Сервис хеширует переданную строку и ищет UserSession по RefreshTokenHash. Проверяет IsRevoked и ExpiresAt, выпускает новую пару, заменяет хеш и продлевает ExpiresAt. CreatedAt также перезаписывается, поэтому после refresh это не исходная дата открытия сессии.
Успех 200:
{"refreshToken":"<new token>","accessToken":"<new token>"}
| Случай | Текущий ответ |
|---|---|
| Пустая строка | 400, errorCode Auth.EmptyToken |
| Хеш не найден | 400, errorCode Auth.InvalidToken |
| Истекшая/отозванная сессия | 400, errorCode Auth.InvalidToken |
Не документируйте неверный refresh как гарантированный 401: текущий Error.Failure преобразуется в 400.
Клиент
Сохраните оба новых токена и сериализуйте refresh-запросы. Ошибка сети не должна автоматически удалять авторизацию пользователя. При подтверждённо недействительном refresh требуется повторный вход.
Ротация сейчас не имеет защиты от конкурентного использования и истории повторного применения. Детали — в разделе «Аутентификация».
Проверено по исходникам на 03.10.2026, commit 4603be9. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: Govor.Application/Users/UserSessions/UserSessionRefresher.cs.