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-токен.

Споріднені статті

← Автентифікація