POST/api/global-chatbot/demo/voice-transcribe

Iguqula ukuqoshwa kwezwi ekhasini ledemo kube ngumbhalo (okungenayo kwezwi), uma umsebenzi wezwi wedemo uvuliwe.

Thumela `visitor_id` (UUID) nefayela lomsindo ensimini ethi `audio` ngokuthi `multipart/form-data`. Impendulo iqukethe umbhalo owaziwayo. Isixhumi sifana ne`POST /api/public/widget/voice-transcribe`, kodwa sihlangene nedemo ku-zentor-app.de. Izimo zephutha: 400 `INVALID_VISITOR_ID` (i-UUID eshodayo noma engasebenzi), 403 `ORIGIN_DENIED` (isibizo asivela ku-zentor-app.de), 413 `AUDIO_TOO_LARGE` (ifayela likhulu kakhulu) ne-415 `AUDIO_TYPE_UNSUPPORTED` (ifomethi engasekelwe).

Ukubuka konke

Ukubiza: POST /api/global-chatbot/demo/voice-transcribe. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: visitor_id (body), audio (body). Izimo zamaphutha ezibhaliwe: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

Yamukela kuphela izicelo ezivela ku-https://zentor-app.de ne-https://www.zentor-app.de; ithokheni yokufaka ayidingekile kudemo.

I-idempotent: Cha

Amapharamitha

visitor_id(body, string, kuyadingeka)— I-ID yesivakashi, kumele ibe i-UUID esemthethweni
audio(body, file, kuyadingeka)— Ifayela lomsindo (`multipart/form-data`)

Isibonelo se-response

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id kumele ibe i-UUID evumelekile."}}

Amakhodi amaphutha

400 INVALID_VISITOR_ID — I-`visitor_id` ayikho noma ayisiyo UUID esemthethweni.
403 ORIGIN_DENIED — Ukubizwa akuveli ku-zentor-app.de.
413 AUDIO_TOO_LARGE — Ifayela lomsindo lidlula usayizi ovunyelwe.
415 AUDIO_TYPE_UNSUPPORTED — Ifomethi yomsindo ayisekelwa.

Ukuziphatha okuhlolwe

I-`visitor_id` engalungile inikeza u-400 `INVALID_VISITOR_ID`, ukubizwa kusuka kusizinda esihlukile u-403 `ORIGIN_DENIED`. Isimo sempumelelo singenziwa kuphela kusuka ku-zentor-app.de.

Idemo ye-chatbot ne-SSO

POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo futhi inikeze impendulo yayo. Idemo ingazanywa ngaphandle kobhalisi kubhrawuza.GET /api/global-chatbot/demo/historyIlayisha umlando wemiyalezo yangaphambilini wengxoxo yedemo ukuze igcinwe uma idemo ivulwa kabusha.POST /api/global-chatbot/demo/pollLithatha imiyalezo emisha yengxoxo yedemo, isibonelo uma isisebenzi se-Zentor sithatha ingxoxo. Ikhasi ledemo libiza isixhumi ngezikhathi ezihleliwe.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusizile noma okungasizile) ngokuphawula okukhethekile.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwa zekhasi ledemo zamanani wezivakashi ze-Zentor.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yinkulumo (umsindo wasekhaya wekhulumo kukhasi lwedemo), uma umsebenzi wenkulumo wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML noma OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komhlinzeki womazisi ngemva kokungena nge-OIDC futhi ibuyisele isiphequluli ku-Zentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamukela impendulo ye-SAML esayiniwe yomhlinzeki womazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML ye-Zentor App (XML) ukuba ifakwe emhlinzekini wenu womazisi.

Izihloko ezihlobene

← Idemo ye-chatbot ne-SSO