בוט צ'אט לדוגמה ו-SSO
בוט הצ'אט הדמוי הציבורי ונקודות הקצה של כניסה אחידה (Single Sign-On).
העמוד "בוט צ'אט לדוגמה ו-SSO — הפניה ל-API" עוסק בתחום הפונקציונלי המצוין בכתובת ה-URL. התוכן הקיים משולב בתיאור תהליך העבודה בפועל, בדרישות המקדימות ובמגבלות הידועות. ל-Zentor אין מערכת מפתחות API למפתחים. לדשבורד משתמשים ב-JWTs של סשן עם תוקף של 12 שעות ובאסימוני רענון עם תוקף של 7 ימים; TOTP ו-SSO הם אופציונליים. אסימוני הטמעת וידג'ט מוצגים פעם אחת בטקסט גלוי וקשורים ל-Origin מאושרים.
יש לקרוא את התיעוד של `POST /api/global-chatbot/demo` כתיאור טכני מחייב של נקודת הקצה הספציפית הזו. המפתח הם שיטת הבקשה, הנתיב, האימות, השדות החובה, השגיאות האפשריות והשאלה האם קריאה חוזרת תפעיל את אותה השפעה. אין לכלול בהקטע עזרה זה https://zentor-app.de/hilfe/api-referenz/demo-und-sso הודעות שיווקיות כלליות, אלא רק שלבי אינטגרציה ניתנים לביצוע לאחר מכן ודוגמאות לתשובות מוכחות.
כדי לקרוא ל-`/api/global-chatbot/demo`, יש לבנות את הבקשה בהתאם לרישום. מסלולים ציבוריים אינם דורשים מפתח API כללי למפתחים, מכיוון ש-Zentor אינה מציעה מערכת מפתחות כזו. לעומת זאת, מסלולי וידג'ט מוגנים משתמשים באסימון הטמעה המוצג פעם אחת ובבדיקת מקור. יש להעריך יחד את סטטוס ה-HTTP ואת תוכן ה-JSON; שדה `ok` לבדו אינו מחליף טיפול בשגיאות.
בבדיקת `POST /api/global-chatbot/demo` יש להשתמש בערכים מאנונימיים. Reale Kundendaten, produktive UUIDs, Sitzungs-Tokens und konkrete Zeitstempel gehören nicht in öffentliche Beispiele. Der bekannte plattformweite Grenzwert liegt bei 2.000 Anfragen innerhalb von 15 Minuten; ein abweichendes Einzellimit ist nicht belegt. Nicht idempotente POST-Aufrufe dürfen nach einem unklaren Netzwerkabbruch nicht blind wiederholt werden.
Typische Integrationsfehler für diese Route entstehen durch fehlende Pflichtparameter, falsche Datentypen, abgelaufene Einmalcodes, nicht erlaubte Origins oder einen nicht implementierten Datensatz. Die Anwendung sollte solche Fälle getrennt behandeln und die vom Endpunkt zurückgelieferte Fehlermeldung protokollieren, ohne geheime Inhalte mitzuschreiben. בקשה מוצלחת מאשרת רק את שלב העיבוד הזה, ולא באופן אוטומטי הצלחה של דוא"ל, תשלום או SSO המצורפים לאחר מכן.
הבדיקה הטכנית של דף זה חייבת להסתמך על הרשומה ב-`app/frontend/src/content/api-reference/` ועל נתיבי ה-Backend הרלוונטיים. הערות בדיקה חיות יכולות לטעון רק את מה שנבדק בפועל. בדיקה שלילית או אנלוגיה בקוד אינם מהווים הוכחה מלאה להצלחה. עבור בוט הצ'אט לדוגמה ו-SSO — יש להבחין בבירור בין המבנה המסומן בתיעוד, הבדיקה האוטומטית וההתנהגות החיה שנצפתה באופן בטוח.