POST/api/global-chatbot/demo/voice-speak
Iguqula umbhalo ube yintetho ekhulunywayo (isandi kwikhasi ledemo), ukuba umsebenzi wentetho yedemo uvulwe.
Thumela `visitor_id` (UUID) nombhalo omawufundwe ku-`text`. Impendulo iqulethe idatha yesandi sokudlala; kwi-elementi ye-`<audio>` kuyafumaneka indlela efanayo nge-GET. Isicelo sihambelana ne-`POST /api/public/widget/voice-speak`, kodwa sibophelelwe kwidemo ku-zentor-app.de kwaye asihloswe ukuba yijongano jikelele lesandi sentetho. Iimeko zempazamo: 400 `INVALID_VISITOR_ID` (i-UUID engekhoyo okanye engasebenziyo), 403 `ORIGIN_DENIED` (ukubizwa akuveli ku-zentor-app.de) kunye no-503 `VOICE_UNAVAILABLE` (umsebenzi wentetho awukafumaneki okwangoku).
Ushwankathelo
Ukubiza: POST /api/global-chatbot/demo/voice-speak. Le endpoint yeyeqela elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza yi-idempotent: ukubiza kaninzi ngolwazi olufanayo kubuyisa isiphumo esifanayo. Iipharamitha ezinyanzelekileyo: visitor_id (body), text (body). Iimeko zeempazamo ezibhaliweyo: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Yamkela kuphela izicelo ezivela ku-https://zentor-app.de ne-https://www.zentor-app.de; i-token yokufaka ayifunekile kwidemo.
Idempotent: Yebo
Iiparamitha
visitor_id(body, string, kuyafuneka)— I-ID yesindwendwe, kufuneka ibe i-UUID esemthethwenitext(body, string, kuyafuneka)— Umbhalo omawufundweUmzekelo we-response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wentetho awukho ngoku."}}Iikhowudi zeempazamo
400 INVALID_VISITOR_ID — I-`visitor_id` ayikho okanye ayisiyo UUID esemthethweni.403 ORIGIN_DENIED — Ukubizwa akuveli ku-zentor-app.de.503 VOICE_UNAVAILABLE — Umsebenzi wentetho awufumaneki okwangoku.Ukuziphatha okujongwe
I-`visitor_id` engasebenziyo inika u-400 `INVALID_VISITOR_ID`, umsebenzi wentetho ongafumanekiyo u-503 `VOICE_UNAVAILABLE`. Imeko yempumelelo inokwenzeka kuphela kusuka ku-zentor-app.de.
Idemo ye-chatbot ne-SSO
POST /api/global-chatbot/demoIthumela umyalezo kwibhoti yokubonisa yoluntu ku-zentor-app.de/demo kwaye inikeze impendulo yayo. Idemo inganzanwa ngaphandle kokubhalisa kwibhrawuza.GET /api/global-chatbot/demo/historyIlayisha imbali yemiyalezo yangaphambili yencoko yedemo ukuze igcinwe xa idemo ivulwa kwakhona.POST /api/global-chatbot/demo/pollLithatha imiyalezo emitsha yencoko yedemo, umzekelo xa umsebenzi we-Zentor uthatha incoko. Iphepha ledemo libiza isidibanisi kumaxesha athile.POST /api/global-chatbot/demo/ratingIgcina ukuvavanywa kwencoko yedemo (okunceda okanye okungancedi) ngokuphawula okukhethiweyo.POST /api/global-chatbot/demo/trackIrekhoda iziganeko zokusetyenziswa ezingaziwayo zephepha ledemo zamanani weendwendwe ze-Zentor.POST /api/global-chatbot/demo/voice-transcribeIguqula uqoshoyi lwezwi kwiphepha ledemo kube ngumbhalo (ongeno lwezwi), ukuba umsebenzi wezwi wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuba ukungena kanye (SAML okanye OIDC) kusetwe na kwi-akhawunti. Iphepha lokungena lisebenzisa isiphumo ukunika ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqalisa ukungena nge-OpenID Connect kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.GET /api/sso/:tenantSlug/oidc/callbackYamkela ukudluliselwa komboneleli wesazisi emva kokungena nge-OIDC kwaye ibuyisela isikhangeli kwi-Zentor App.GET /api/sso/:tenantSlug/saml/startIqalisa ukungena nge-SAML kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamkela impendulo ye-SAML esayinweyo yomboneleli wesazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza iinkcukacha ze-SAML ze-Zentor App (XML) ukuba zifakwe kumboneleli wenu wesazisi.