POST/api/auth/refresh
Обменивает действительный refresh-токен на новую пару токена доступа и refresh-токена.
Отправьте последний полученный `refreshToken` в теле JSON. Ответ содержит новый `token` и новый `refreshToken`. Каждый refresh-токен можно использовать только один раз, и по умолчанию он действителен семь дней; после каждого вызова сохраняйте новый токен и удаляйте старый. Отсутствующий, недействительный, истёкший или уже использованный refresh-токен приводит к коду 400 `VALIDATION_ERROR`. В этом случае пользователь должен снова войти через `POST /api/auth/login`. Поскольку refresh-токен расходуется при использовании, клиенту следует избегать параллельных обновлений.
Обзор
Вызов: POST /api/auth/refresh. Этот эндпоинт относится к группе «Аутентификация» API Zentor App. Он общедоступен и не требует аутентификации. Вызов не идемпотентен: каждый успешный вызов заново запускает действие. Обязательные параметры: refreshToken (тело). Задокументированные случаи ошибок: 400 VALIDATION_ERROR. Пример ответа ниже показывает структуру успешного ответа в формате JSON.
Аутентификация и защита
Аутентификация не требуется
Идемпотентный: Нет
Параметры
refreshToken(body, string, обязательно)— Последний выданный refresh-токенПример запроса
{"refreshToken":"<Refresh-токен из /login>"}Пример ответа
{"ok":true,"token":"<новый JWT>","refreshToken":"<новый Refresh-токен>"}Коды ошибок
400 VALIDATION_ERROR — Refresh-токен отсутствует, недействителен, истёк или уже был использован.Проверенное поведение
Действительный refresh-токен возвращает новую пару токенов; недействительный токен возвращает 400 `VALIDATION_ERROR`.
Аутентификация
POST /api/auth/loginВыполняет вход пользователя по email или имени пользователя и паролю и выдаёт токен доступа (JWT) и refresh-токен.POST /api/auth/forgot-passwordЗапускает сброс пароля: если аккаунт с указанным email существует, на него приходит письмо со ссылкой для сброса.POST /api/auth/reset-passwordУстанавливает новый пароль с помощью токена сброса из письма.POST /api/auth/sso/exchangeПоследний шаг входа через SSO (SAML/OIDC): обменивает одноразовый код из перенаправления на токен доступа и refresh-токен.