mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
44 lines
2.5 KiB
Markdown
44 lines
2.5 KiB
Markdown
---
|
|
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:
|
|
|
|
```json
|
|
{"refreshToken":"<последний сохранённый refresh token>"}
|
|
```
|
|
|
|
Сервис хеширует переданную строку и ищет UserSession по RefreshTokenHash. Проверяет IsRevoked и ExpiresAt, выпускает новую пару, заменяет хеш и продлевает ExpiresAt. CreatedAt также перезаписывается, поэтому после refresh это не исходная дата открытия сессии.
|
|
|
|
Успех 200:
|
|
|
|
```json
|
|
{"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](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Application/Users/UserSessions/UserSessionRefresher.cs).
|