Demo-Chatbot at SSO
Ang pampublikong demo chatbot at ang mga endpoint para sa single sign-on.
Ang pahina na "Demo-Chatbot at SSO — API Reference" ay tumutukoy sa saklaw ng functionality na nakasaad sa URL. Ang kasalukuyang nilalaman ay dinagdagan ng aktwal na proseso, mga kinakailangan, at mga kilalang limitasyon. Ang Zentor ay walang sistema ng developer API key. Para sa dashboard, ginagamit ang mga Session-JWT na may labindalawang oras na tagal at mga Refresh Token na may pitong araw na tagal; ang TOTP at SSO ay opsyonal. Ang mga Widget-Embed Token ay ipinapakita nang isang beses sa plain text at nakatali sa mga awtorisadong pinagmulan.
Ang dokumentasyon para sa `POST /api/global-chatbot/demo` ay dapat basahin bilang isang teknikal na paglalarawan ng partikular na endpoint na ito. Mahalaga ang pamamaraan, landas, pagpapatunay, mga kinakailangang field, posibleng mga error, at kung ang isang muling pagtawag ay magdudulot ng parehong epekto. Samakatuwid, ang seksyon ng tulong na ito na https://zentor-app.de/hilfe/api-referenz/demo-und-sso ay hindi dapat maglaman ng mga pangkalahatang pahayag sa advertising, ngunit dapat lamang maglaman ng mga nasusukat na hakbang sa pagsasama at mga napatunayang halimbawa ng tugon.
Para sa isang tawag sa `/api/global-chatbot/demo`, ang kahilingan ay binuo alinsunod sa registry. Ang mga pampublikong ruta ay hindi nangangailangan ng isang pangkalahatang developer API key dahil ang Zentor ay walang ganitong sistema ng key. Ang mga protektadong ruta ng widget, sa kabilang banda, ay gumagamit ng isang Embed Token na ipinapakita nang isang beses at isang pagsusuri ng pinagmulan. Ang HTTP status at ang nilalaman ng JSON ay dapat suriin nang magkasama; ang isang field na `ok` lamang ay hindi pumapalit sa paghawak ng error.
Kapag sinusubukan ang `POST /api/global-chatbot/demo`, dapat gamitin ang mga inilagay na halaga. Ang mga tunay na data ng customer, produktibong UUID, mga token ng sesyon, at mga tiyak na timestamp ay hindi dapat isama sa mga pampublikong halimbawa. Ang kilalang limitasyon sa buong platform ay 2,000 na kahilingan sa loob ng 15 minuto; walang napatunayang indibidwal na limitasyon. Ang mga hindi idempotent na POST call ay hindi dapat ulitin nang basta-basta pagkatapos ng hindi malinaw na pagkabigo ng network.
Ang mga karaniwang pagkakamali sa pagsasama para sa rutang ito ay sanhi ng mga nawawalang kinakailangang parameter, maling mga uri ng data, mga expired na one-time code, mga hindi pinapayagang pinagmulan, o isang dataset na hindi naipatupad. Ang aplikasyon ay dapat na pangasiwaan ang mga kasong ito nang hiwalay at i-log ang mensahe ng error na ibinalik ng endpoint, nang hindi isinusulat ang anumang sensitibong nilalaman. Ang isang matagumpay na kahilingan ay nagkukumpirma lamang sa hakbang na ito ng pagproseso, hindi awtomatikong isang kasunod na tagumpay sa email, pagbabayad, o SSO.
Ang teknikal na pagsusuri ng pahinang ito ay dapat na batay sa registry sa `app/frontend/src/content/api-reference/` at ang mga kaugnay na backend route. Ang mga live na tala ng pagsubok ay dapat lamang magpahayag ng kung ano ang talagang nasuri. Ang isang negatibong pagsubok o isang pagkakapareho ng code ay hindi isang kumpletong patunay ng tagumpay. Samakatuwid, para sa Demo-Chatbot at SSO — API Reference, mahalagang makilala ang dokumentadong istraktura, awtomatikong pagsubok, at ligtas na naobserbahang live na pag-uugali.