Chatbot demo și SSO
Chatbotul demo public și endpointurile Single Sign-On.
Pagina „Chatbot demo și SSO — referință API” tratează domeniul funcțional indicat în URL. Conținutul existent este completat cu fluxul real, condițiile preliminare și limitele cunoscute. Zentor nu dispune de un sistem de chei API pentru dezvoltatori. Pentru dashboard se folosesc JWT-uri de sesiune cu o valabilitate de douăsprezece ore și refresh tokenuri cu o valabilitate de șapte zile; TOTP și SSO sunt opționale. Tokenurile de embed pentru widget sunt afișate o singură dată în text clar și sunt legate de originile permise.
Documentația pentru `POST /api/global-chatbot/demo` trebuie citită în mod obligatoriu ca descriere tehnică a acestui endpoint concret. Esențiale sunt metoda, calea, autentificarea, câmpurile obligatorii, erorile posibile și întrebarea dacă un apel repetat declanșează același efect. Prin urmare, această secțiune de ajutor https://zentor-app.de/hilfe/api-referenz/demo-und-sso nu trebuie să conțină afirmații promoționale generale, ci doar pași de integrare ce pot fi urmăriți ulterior și exemple de răspuns documentate.
Pentru un apel către `/api/global-chatbot/demo`, cererea este construită conform registry-ului. Rutele publice nu necesită o cheie API generală pentru dezvoltatori, deoarece Zentor nu oferă un astfel de sistem de chei. În schimb, rutele de widget protejate folosesc tokenul de embed afișat o singură dată și o verificare a originii. Statusul HTTP și conținutul JSON trebuie evaluate împreună; un câmp `ok` singur nu înlocuiește gestionarea erorilor.
La testarea `POST /api/global-chatbot/demo` trebuie folosite valori anonimizate. Datele reale ale clienților, UUID-urile din producție, tokenurile de sesiune și marcajele de timp concrete nu au ce căuta în exemplele publice. Limita cunoscută la nivelul platformei este de 2.000 de cereri în 15 minute; o limită individuală diferită nu este documentată. Apelurile POST neidempotente nu trebuie repetate orbește după o întrerupere neclară a rețelei.
Erorile tipice de integrare pentru această rută apar din cauza parametrilor obligatorii lipsă, a tipurilor de date greșite, a codurilor unice expirate, a originilor nepermise sau a unei înregistrări neimplementate. Aplicația ar trebui să trateze separat aceste cazuri și să înregistreze mesajul de eroare returnat de endpoint, fără a consemna conținut secret. O cerere reușită confirmă doar acest pas de procesare, nu și automat reușita ulterioară a unui e-mail, a unei plăți sau a SSO.
Verificarea tehnică a acestei pagini trebuie să se bazeze obligatoriu pe registry-ul din `app/frontend/src/content/api-reference/` și pe rutele backend aferente. Mențiunile privind testele live pot afirma doar ceea ce a fost efectiv verificat. Un test negativ sau o analogie de cod nu reprezintă o dovadă completă de succes. Prin urmare, pentru Chatbot demo și SSO — referință API trebuie făcută o distincție clară între structura documentată, testul automatizat și comportamentul live observat cu certitudine.