POST/api/global-chatbot/demo/voice-transcribe
Iguqula ukuqoshwa kwezwi ekhasini ledemo kube umbhalo (ukungena kwezwi), nxa umsebenzi wezwi wedemo uvuliwe.
Thumelani `visitor_id` (UUID) kanye lefayili lemsindo ensimini ethi `audio` ngokuthi `multipart/form-data`. Impendulo iqukethe umbhalo owaziweyo. Isihlanganiso siyahambisana nge`POST /api/public/widget/voice-transcribe`, kodwa sihlangene lademo kuzentor-app.de. Izimo zephutha: 400 `INVALID_VISITOR_ID` (i-UUID eswelekileyo kumbe engasebenziyo), 403 `ORIGIN_DENIED` (isibizo kasivela kuzentor-app.de), 413 `AUDIO_TOO_LARGE` (ifayili likhulu kakhulu) le-415 `AUDIO_TYPE_UNSUPPORTED` (ifomethi engasekelwe).
Isifinyezo
Ukubiza: POST /api/global-chatbot/demo/voice-transcribe. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot le-SSO” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: visitor_id (body), audio (body). Izimo zamaphutha ezibhaliweyo: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubuwena lokuvikeleka
Kakudingeki ukuqinisekisa ubuwena
Yamukela kuphela izicelo ezivela ku-https://zentor-app.de kanye le-https://www.zentor-app.de; ithokheni yokufaka kayidingakali kudemo.
I-idempotent: Hatshi
Amapharamitha
visitor_id(body, string, kuyadingeka)— I-ID yesivakatshi, kumele ibe i-UUID esemthethweniaudio(body, file, kuyadingeka)— Ifayili yomsindo (`multipart/form-data`)Isibonelo sempendulo (response)
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id kumele ibe yi-UUID evumelekileyo."}}Amakhodi amaphutha
400 INVALID_VISITOR_ID — I-`visitor_id` kayikho kumbe kayisiyo UUID esemthethweni.403 ORIGIN_DENIED — Ukubizwa kakuveli ku-zentor-app.de.413 AUDIO_TOO_LARGE — Ifayili yomsindo yedlula usayizi ovunyelweyo.415 AUDIO_TYPE_UNSUPPORTED — Ifomathi yomsindo kayisekelwa.Ukuziphatha okuhlolwe
I-`visitor_id` engalungile inika u-400 `INVALID_VISITOR_ID`, ukubizwa okuvela kudomeyini eyahlukeneyo u-403 `ORIGIN_DENIED`. Isimo sempumelelo singenzakala kuphela kuvela ku-zentor-app.de.
Idemo ye-chatbot le-SSO
POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo njalo inikeze impendulo yayo. Idemo ingazanywa ngaphandle kokubhalisa kubhrawuza.GET /api/global-chatbot/demo/historyIlayitsha umlando wemilayezo wangaphambilini wengxoxo yedemo ukuthi igcinwe nxa idemo ivulwa kutsha.POST /api/global-chatbot/demo/pollLithatha imilayezo emitsha yengxoxo yedemo, isibonelo nxa isisebenzi seZentor sithatha ingxoxo. Ikhasi ledemo libiza isihlanganiso ngezikhathi ezihleliweyo.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusiza kumbe okungasizi) ngokuphawula okukhethiweyo.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwayo zekhasi ledemo zamanani wezivakatshi zeZentor.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yikhulumo (umsindo kukhasi ledemo), nxa umsebenzi wenkulumo wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML kumbe OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komnikezeli wesazisi ngemva kokungena nge-OIDC njalo ibuyisela isikhangeli kuZentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamukela impendulo ye-SAML esayinweyo yomnikezeli wesazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML yeZentor App (XML) ukuba ifakwe emnikezelini wenu wesazisi.