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`. Успешный случай предполагает полный вход у настроенного провайдера идентификации.

Аутентификация

Связанные статьи

← Аутентификация