GET/api/global-chatbot/demo/history
Ilayisha imbali yemiyalezo yangaphambili yencoko yedemo ukuze igcinwe xa idemo ivulwa kwakhona.
Dlulisela `session_id` kunye ne`visitor_id` njengeepharamitha zombuzo; zombini kufuneka zivele kwincoko yedemo enye. Impendulo iqulathe kwinjini ethi `data` uluhlu `messages` nge`id`, `role`, `text` kunye ne`created_at`. Intlanganiso ifunda kuphela kwaye ihambelana. Ukuba ishoda enye yeepharamitha, iseva iphendula nge-400 `PARAMS_REQUIRED`. Ukuba iseshoni ayisaziwa, qalisa incoko entsha yedemo.
Ushwankathelo
Ukubiza: GET /api/global-chatbot/demo/history. 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: session_id (query), visitor_id (query). Iimeko zeempazamo ezibhaliweyo: 400 PARAMS_REQUIRED. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Idempotent: Yebo
Iiparamitha
session_id(query, string, kuyafuneka)— I-ID yeseshoni yencoko yedemovisitor_id(query, string, kuyafuneka)— I-ID yesindwendwe (UUID) evelisiweyo yiphepha ledemoUmzekelo we-response
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Molo, i-Zentor ibiza malini?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ndinokukubonisa ukuba oku kuya kubonakala njani kwimeko yakho — ngaphandle kwesibophelelo.","created_at":"2026-07-20T17:07:02.329Z"}]}}Iikhowudi zeempazamo
400 PARAMS_REQUIRED — I-`session_id` okanye i-`visitor_id` ayikho.Ukuziphatha okujongwe
Iseshoni yedemo ekhoyo inika u-200 nembali; iimfameta ezingekho zinika u-400 `PARAMS_REQUIRED`.
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.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.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yintetho ekhulunywayo (isandi kwikhasi ledemo), ukuba umsebenzi wentetho yedemo uvulwe.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.