POST/api/global-chatbot/demo/voice-transcribe
Pretvori glasovni posnetek na demo strani v besedilo (govorni vnos), če je glasovna funkcija demo verzije aktivirana.
Pošljite `visitor_id` (UUID) in avdio datoteko v polju `audio` kot `multipart/form-data`. Odgovor vsebuje prepoznano besedilo. Končna točka ustreza `POST /api/public/widget/voice-transcribe`, vendar je vezana na demo na zentor-app.de. Primeri napak: 400 `INVALID_VISITOR_ID` (manjkajoč ali neveljaven UUID), 403 `ORIGIN_DENIED` (klic ni iz zentor-app.de), 413 `AUDIO_TOO_LARGE` (datoteka prevelika) in 415 `AUDIO_TYPE_UNSUPPORTED` (format ni podprt).
Pregled
Klic: POST /api/global-chatbot/demo/voice-transcribe. Ta endpoint spada v skupino »Demo klepetalni robot in SSO« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: visitor_id (body), audio (body). Dokumentirani primeri napak: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.
Avtentikacija in zaščita
Avtentikacija ni potrebna
Sprejme samo klice z https://zentor-app.de in https://www.zentor-app.de; žeton za vdelavo za demo ni potreben.
Idempotentno: Ne
Parametri
visitor_id(body, string, obvezno)— ID obiskovalca, mora biti veljaven UUIDaudio(body, file, obvezno)— Avdio datoteka (`multipart/form-data`)Primer odgovora
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id mora biti veljaven UUID."}}Kode napak
400 INVALID_VISITOR_ID — `visitor_id` manjka ali ni veljaven UUID.403 ORIGIN_DENIED — Klic ne prihaja iz zentor-app.de.413 AUDIO_TOO_LARGE — Avdio datoteka presega dovoljeno velikost.415 AUDIO_TYPE_UNSUPPORTED — Avdio format ni podprt.Preverjeno vedenje
Neveljaven `visitor_id` vrne 400 `INVALID_VISITOR_ID`, klic z druge domene 403 `ORIGIN_DENIED`. Primer uspeha je mogoč samo iz zentor-app.de.
Demo klepetalni robot in SSO
POST /api/global-chatbot/demoPošlje sporočilo javnemu demo klepetalnemu robotu na zentor-app.de/demo in vrne njegov odgovor. Demo lahko preizkusite v brskalniku brez registracije.GET /api/global-chatbot/demo/historyNaloži dotedanji potek sporočil demo pogovora, da se ohrani ob ponovnem odprtju demo verzije.POST /api/global-chatbot/demo/pollPridobi nova sporočila demo pogovora, na primer ko je sodelavec Zentor prevzel pogovor. Demo stran kliče končno točko v presledkih.POST /api/global-chatbot/demo/ratingShrani oceno demo pogovora (koristno ali nekoristno) z neobveznim komentarjem.POST /api/global-chatbot/demo/trackZajema anonimne dogodke uporabe demo strani za statistiko obiskovalcev Zentor.POST /api/global-chatbot/demo/voice-speakPretvori besedilo v govor (glasovni izhod na demo strani), če je glasovna funkcija demo verzije aktivirana.GET /api/sso/:tenantSlug/statusPreveri, ali je za račun nastavljena enotna prijava (SAML ali OIDC). Stran za prijavo uporabi rezultat za ponudbo prijave SSO.GET /api/sso/:tenantSlug/oidc/startSproži prijavo prek OpenID Connect in preusmeri brskalnik na nastavljenega ponudnika identitete.GET /api/sso/:tenantSlug/oidc/callbackSprejme preusmeritev ponudnika identitete po prijavi OIDC in preusmeri brskalnik nazaj na Zentor App.GET /api/sso/:tenantSlug/saml/startSproži prijavo prek SAML in preusmeri brskalnik na nastavljenega ponudnika identitete.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): sprejme podpisan odgovor SAML ponudnika identitete prek obrazca POST.GET /api/sso/:tenantSlug/saml/metadataVrne SAML metapodatke Zentor App (XML) za uvoz v vašega ponudnika identitete.