Files
Govor/docs/endpoints/authentication/refreshcontroller.md
T
Artemy 632ac04b56 Add forwarding, friend controls, and benefits
Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
2026-10-31 18:29:40 +07:00

32 lines
2.1 KiB
Markdown

# Обновление токенов
## POST /api/auth/token/refresh
Доступ анонимный. JSON:
```json
{"refreshToken":"<последний сохранённый refresh token>"}
```
Сервис ищет сессию по хешу строки, проверяет отзыв и срок, создаёт новую пару и условно заменяет хеш только если старый ещё актуален. `ExpiresAt` продлевается, `CreatedAt` сохраняет исходную дату открытия сессии.
Успех `200`:
```json
{"refreshToken":"<new refresh>","accessToken":"<new access>"}
```
| Случай | Ответ |
| --- | --- |
| Пустая строка | 400, `Auth.EmptyToken` |
| Неизвестный, истёкший или отозванный refresh | 400, `Auth.InvalidToken` |
| Сессия изменилась между чтением и условной заменой | 401, `Auth.InvalidToken` |
Повтор старого токена после успешной ротации не является штатным способом повторить запрос. Различие 400/401 зависит от момента обнаружения конфликта; не привязывайте восстановление клиента только к одному из статусов.
## Поведение клиента
Выполняйте один refresh за раз для всех параллельных HTTP-запросов и хабов. Сохраняйте оба новых токена вместе. Если ответ потерялся после серверного сохранения, старая строка уже может быть недействительна и потребуется новый вход.
Сетевой сбой или `5xx` не подтверждает недействительность токена. Повторный вход не должен удалять приватные ключи истории. [Пароль и восстановление](../../password-recovery.md).