POST/api/global-chatbot/demo/voice-transcribe
若演示的语音功能已启用,将演示页面上的语音录音转换为文本(语音输入)。
发送 `visitor_id`(UUID)以及音频数据,作为 `audio` 字段的 `multipart/form-data`。响应包含识别出的文本。此端点对应 `POST /api/public/widget/voice-transcribe`,但仅限用于 zentor-app.de 的演示。 错误情况:400 `INVALID_VISITOR_ID`(UUID 缺失或无效)、403 `ORIGIN_DENIED`(调用不是来自 zentor-app.de)、413 `AUDIO_TOO_LARGE`(文件过大)以及 415 `AUDIO_TYPE_UNSUPPORTED`(格式不受支持)。
概览
调用:POST /api/global-chatbot/demo/voice-transcribe。该端点属于 Zentor App API 的“演示聊天机器人与 SSO”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:visitor_id (请求体), audio (请求体)。 已记录的错误情况:400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED。 下方的示例响应展示了 JSON 格式的成功响应结构。
身份验证与安全
无需身份验证
仅接受来自 https://zentor-app.de 和 https://www.zentor-app.de 的调用;演示不需要嵌入令牌。
幂等: 否
参数
visitor_id(body, string,必填)— 访客 ID,必须是有效的 UUIDaudio(body, file,必填)— 作为文件的音频数据(`multipart/form-data`)响应示例
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}错误代码
400 INVALID_VISITOR_ID — `visitor_id` 缺失或不是有效的 UUID。403 ORIGIN_DENIED — 该调用不是来自 zentor-app.de。413 AUDIO_TOO_LARGE — 音频文件超过允许的大小。415 AUDIO_TYPE_UNSUPPORTED — 不支持该音频格式。已验证的行为
无效的 `visitor_id` 返回 400 `INVALID_VISITOR_ID`,来自其他域名的调用返回 403 `ORIGIN_DENIED`。成功情况只能从 zentor-app.de 发起。
演示聊天机器人与 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-speak若演示的语音功能已启用,将文本转换为语音(演示页面上的语音输出)。GET /api/sso/:tenantSlug/status检查某个账户是否已配置单一登录(SAML 或 OIDC)。登录页面会使用该结果来提供 SSO 登录选项。GET /api/sso/:tenantSlug/oidc/start启动通过 OpenID Connect 的登录,并将浏览器重定向到已配置的身份提供商。GET /api/sso/:tenantSlug/oidc/callback接收 OIDC 登录后身份提供商的重定向,并将浏览器重定向回 Zentor App。GET /api/sso/:tenantSlug/saml/start启动通过 SAML 的登录,并将浏览器重定向到已配置的身份提供商。POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service(ACS):通过表单 POST 接收身份提供商已签名的 SAML 响应。GET /api/sso/:tenantSlug/saml/metadata返回用于导入您身份提供商的 Zentor App SAML 元数据(XML)。