GET/api/sso/:tenantSlug/oidc/callback
Принимает перенаправление от провайдера идентификации после входа через OIDC и перенаправляет браузер обратно к Zentor App.
Этот эндпоинт вызывается исключительно провайдером идентификации через перенаправление браузера; его нужно указать в его настройках как Redirect-URI. При успехе Zentor App перенаправляет браузер обратно с одноразовым кодом в query-параметре `sso_code`; этот код обменивается на токен доступа через `POST /api/auth/sso/exchange`. При ошибке — например, если параметр безопасности `state` отсутствует или недействителен — сервер перенаправляет на страницу входа с query-параметром `sso_error`, например `sso_error=SSO_STATE_MISSING`. В этом случае начните вход заново.
Обзор
Вызов: GET /api/sso/:tenantSlug/oidc/callback. Этот эндпоинт относится к группе «Демо-чат-бот и SSO» API Zentor App. Он общедоступен и не требует аутентификации. Вызов не идемпотентен: каждый успешный вызов заново запускает действие. Обязательные параметры: tenantSlug (путь). Задокументированные случаи ошибок: 302 SSO_STATE_MISSING.
Аутентификация и защита
Аутентификация не требуется
Идемпотентный: Нет
Параметры
tenantSlug(path, string, обязательно)— Идентификатор (slug) аккаунта, для которого настроен SSOПример ответа
Перенаправление 302 на https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (пример без действительного `state`)
Коды ошибок
302 SSO_STATE_MISSING — Перенаправление на страницу входа с `sso_error`, если `state` отсутствует или недействителен.Проверенное поведение
Без действительного `state` сервер перенаправляет кодом 302 с `sso_error=SSO_STATE_MISSING` на страницу входа.
Демо-чат-бот и SSO
POST /api/global-chatbot/demoОтправляет сообщение публичному демо-чат-боту на zentor-app.de/demo и возвращает его ответ. Демо можно опробовать в браузере без регистрации.GET /api/global-chatbot/demo/historyЗагружает предыдущую историю сообщений демо-разговора, чтобы она сохранялась при повторном открытии демо.POST /api/global-chatbot/demo/pollПолучает новые сообщения демо-разговора, например когда сотрудник Zentor взял разговор на себя. Страница демо вызывает эндпоинт с интервалами.POST /api/global-chatbot/demo/ratingСохраняет оценку демо-разговора (полезно или бесполезно) с необязательным комментарием.POST /api/global-chatbot/demo/trackФиксирует анонимные события использования страницы демо для статистики посетителей Zentor.POST /api/global-chatbot/demo/voice-transcribeПреобразует голосовую запись на странице демо в текст (голосовой ввод), если голосовая функция демо активирована.POST /api/global-chatbot/demo/voice-speakПреобразует текст в речь (голосовой вывод на странице демо), если голосовая функция демо активирована.GET /api/sso/:tenantSlug/statusПроверяет, настроен ли для аккаунта единый вход (SAML или OIDC). Страница входа использует результат, чтобы предложить вход через SSO.GET /api/sso/:tenantSlug/oidc/startЗапускает вход через OpenID Connect и перенаправляет браузер к настроенному провайдеру идентификации.GET /api/sso/:tenantSlug/saml/startЗапускает вход через SAML и перенаправляет браузер к настроенному провайдеру идентификации.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): принимает подписанный SAML-ответ провайдера идентификации через форму POST.GET /api/sso/:tenantSlug/saml/metadataВозвращает SAML-метаданные Zentor App (XML) для импорта в вашего провайдера идентификации.