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