POST/api/auth/sso/exchange
Останній крок входу через SSO (SAML/OIDC): обмінює одноразовий код із переспрямування на токен доступу та refresh-токен.
Після входу у провайдера ідентифікації Zentor App переспрямовує браузер назад з одноразовим кодом у query-параметрі `sso_code`. Надішліть цей код у полі `code`. Відповідь містить `token` і `refreshToken`, як при звичайному вході. Кожен код дійсний лише один раз і недовго. Уже використаний, застарілий або недійсний код призводить до коду 400 `SSO_EXCHANGE_INVALID`; у цьому разі користувач знову запускає вхід через SSO. Тому виклик не ідемпотентний.
Огляд
Виклик: POST /api/auth/sso/exchange. Цей ендпоінт належить до групи «Автентифікація» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: code (тіло). Задокументовані випадки помилок: 400 SSO_EXCHANGE_INVALID. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.
Автентифікація та захист
Автентифікація не потрібна
Ідемпотентний: Ні
Параметри
code(body, string, обов'язково)— Одноразовий код із переспрямування SSOПриклад запиту
{"code":"<одноразовий код із переспрямування SSO-Callback>"}Приклад відповіді
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Коди помилок
400 SSO_EXCHANGE_INVALID — Код недійсний, уже використаний або застарілий.Перевірена поведінка
Недійсний код повертає 400 `SSO_EXCHANGE_INVALID`. Успішний випадок передбачає повний вхід у налаштованого провайдера ідентифікації.
Автентифікація
POST /api/auth/loginВиконує вхід користувача за email або іменем користувача та паролем і видає токен доступу (JWT) і refresh-токен.POST /api/auth/refreshОбмінює дійсний refresh-токен на нову пару токена доступу та refresh-токена.POST /api/auth/forgot-passwordЗапускає скидання пароля: якщо акаунт із вказаним email існує, на нього надходить лист із посиланням для скидання.POST /api/auth/reset-passwordВстановлює новий пароль за допомогою токена скидання з листа.