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Устанавливает новый пароль с помощью токена сброса из письма.