POST/api/global-chatbot/demo/voice-transcribe
Hubadilisha rekodi ya sauti kwenye ukurasa wa onyesho kuwa maandishi (ingizo la sauti), ikiwa kipengele cha sauti cha onyesho kimewezeshwa.
Tumeni `visitor_id` (UUID) na faili ya sauti kwenye sehemu `audio` kama `multipart/form-data`. Jibu lina maandishi yaliyotambuliwa. Kituo kinalingana na `POST /api/public/widget/voice-transcribe`, lakini kimefungwa kwa onyesho kwenye zentor-app.de. Hali za makosa: 400 `INVALID_VISITOR_ID` (UUID inayokosekana au batili), 403 `ORIGIN_DENIED` (wito si kutoka zentor-app.de), 413 `AUDIO_TOO_LARGE` (faili kubwa sana) na 415 `AUDIO_TYPE_UNSUPPORTED` (muundo hauauniki).
Muhtasari
Mwito: POST /api/global-chatbot/demo/voice-transcribe. Endpoint hii ni sehemu ya kundi la “Chatbot ya demo na SSO” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: visitor_id (body), audio (body). Hali za hitilafu zilizoandikwa: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Hupokea tu maombi kutoka https://zentor-app.de na https://www.zentor-app.de; tokeni ya kupachika haihitajiki kwa demo.
Idempotent: Hapana
Vigezo
visitor_id(body, string, inahitajika)— ID ya mgeni, inapaswa kuwa UUID sahihiaudio(body, file, inahitajika)— Faili ya sauti (`multipart/form-data`)Mfano wa jibu (response)
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}Misimbo ya hitilafu
400 INVALID_VISITOR_ID — `visitor_id` haipo au si UUID sahihi.403 ORIGIN_DENIED — Ombi halitoki kwenye zentor-app.de.413 AUDIO_TOO_LARGE — Faili ya sauti inazidi ukubwa unaoruhusiwa.415 AUDIO_TYPE_UNSUPPORTED — Umbizo wa sauti haukusaidiwi.Tabia iliyoangaliwa
`visitor_id` isiyo sahihi hutoa 400 `INVALID_VISITOR_ID`, ombi kutoka kikoa kingine 403 `ORIGIN_DENIED`. Hali ya mafanikio inawezekana tu kutoka zentor-app.de.
Chatbot ya demo na SSO
POST /api/global-chatbot/demoHutuma ujumbe kwa boti ya onyesho ya umma kwenye zentor-app.de/demo na hutoa jibu lake. Onyesho linaweza kujaribiwa bila kujisajili kwenye kivinjari.GET /api/global-chatbot/demo/historyHupakia historia ya awali ya ujumbe wa mazungumzo ya onyesho ili ihifadhiwe wakati onyesho linapofunguliwa tena.POST /api/global-chatbot/demo/pollHupata ujumbe mpya wa mazungumzo ya onyesho, kwa mfano wakati mfanyakazi wa Zentor amechukua mazungumzo. Ukurasa wa onyesho huita kituo kwa vipindi.POST /api/global-chatbot/demo/ratingHuhifadhi tathmini ya mazungumzo ya onyesho (ya manufaa au si ya manufaa) na maoni ya hiari.POST /api/global-chatbot/demo/trackHurekodi matukio ya matumizi yasiyojulikana ya ukurasa wa onyesho kwa takwimu za wageni wa Zentor.POST /api/global-chatbot/demo/voice-speakHubadilisha maandishi kuwa sauti inayosemwa (matamshi kwenye ukurasa wa demo), ikiwa kipengele cha sauti cha demo kimewezeshwa.GET /api/sso/:tenantSlug/statusHuangalia kama kuingia mara moja (SAML au OIDC) kumewekwa kwa akaunti. Ukurasa wa kuingia hutumia matokeo kutoa kuingia kwa SSO.GET /api/sso/:tenantSlug/oidc/startHuanzisha kuingia kupitia OpenID Connect na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.GET /api/sso/:tenantSlug/oidc/callbackHupokea uelekezaji wa mtoa huduma wa utambulisho baada ya kuingia kwa OIDC na kurudisha kivinjari kwa Zentor App.GET /api/sso/:tenantSlug/saml/startHuanzisha kuingia kupitia SAML na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): hupokea jibu la SAML lililotiwa saini kutoka mtoa huduma wa utambulisho kwa fomu ya POST.GET /api/sso/:tenantSlug/saml/metadataHutoa metadata ya SAML ya Zentor App (XML) kwa kuingiza kwenye mtoa huduma wenu wa utambulisho.