Demo-Chatbot və SSO
İctimai demo chatbot və Single-Sign-On endpointləri.
„Demo-Chatbot və SSO — API İstinadı“ səhifəsi URL-də göstərilən funksional sahəni əhatə edir. Mövcud məzmun faktiki axın, ilkin şərtlər və məlum məhdudiyyətlərlə tamamlanır. Zentor-un tərtibatçı API açar sistemi yoxdur. Dashboard üçün on iki saat etibarlılıq müddəti olan sessiya JWT-ləri və yeddi gün etibarlılıq müddəti olan yeniləmə tokenləri istifadə olunur; TOTP və SSO isteğe bağlıdır. Vidjet yerləşdirmə tokenləri bir dəfə açıq mətndə göstərilir və icazə verilən mənşələrə bağlıdır.
`POST /api/global-chatbot/demo` sənədləşməsi bu konkret endpoint-in texniki təsviri kimi məcburi şəkildə oxunmalıdır. Əsas əhəmiyyət kəsb edənlər metod, yol, autentifikasiya, məcburi sahələr, mümkün xətalar və təkrar çağırışın eyni effekti yaradıb-yaratmadığı sualıdır. Bu yardım bölməsi https://zentor-app.de/hilfe/api-referenz/demo-und-sso buna görə ümumi reklam ifadələri ehtiva etməməli, yalnız sonradan yerinə yetirilə bilən inteqrasiya addımları və sübut edilmiş cavab nümunələri olmalıdır.
`/api/global-chatbot/demo` çağırışı üçün sorğu registry-ə uyğun qurulur. Açıq marşrutlar ümumi tərtibatçı API açarı tələb etmir, çünki Zentor belə bir açar sistemi təqdim etmir. Qorunan vidjet marşrutları isə bir dəfə göstərilən embed token və origin yoxlaması istifadə edir. HTTP statusu və JSON məzmunu birlikdə qiymətləndirilməlidir; tək `ok` sahəsi xəta idarəetməsini əvəz etmir.
`POST /api/global-chatbot/demo` testində anonimləşdirilmiş dəyərlər istifadə edilməlidir. Real müştəri məlumatları, istehsal UUID-ləri, sessiya tokenləri və konkret vaxt damğaları ictimai nümunələrə aid deyil. Məlum platforma miqyaslı hədd 15 dəqiqə ərzində 2.000 sorğudur; fərqli fərdi limit sübut olunmayıb. İdempotent olmayan POST çağırışları qeyri-müəyyən şəbəkə kəsilməsindən sonra kor-koranə təkrarlanmamalıdır.
Bu marşrut üçün tipik inteqrasiya xətaları məcburi parametrlərin olmaması, yanlış məlumat tipləri, vaxtı keçmiş birdəfəlik kodlar, icazə verilməyən originlər və ya həyata keçirilməmiş məlumat dəsti səbəbindən yaranır. Tətbiq bu halları ayrıca idarə etməli və endpoint tərəfindən qaytarılan xəta mesajını gizli məzmunları qeyd etmədən protokollaşdırmalıdır. Uğurlu sorğu yalnız bu emal addımını təsdiqləyir, sonradan əlavə olunan e-poçt, ödəniş və ya SSO uğurunu avtomatik təsdiqləmir.
Bu səhifənin texniki yoxlanışı mütləq `app/frontend/src/content/api-reference/` altındakı registry-ə və müvafiq backend marşrutlarına əsaslanmalıdır. Canlı test qeydləri yalnız həqiqətən yoxlanılmış şeyi iddia edə bilər. Mənfi test və ya kod analoqiyası tam uğur sübutu deyil. Demo chatbot və SSO üçün — API istinadı buna görə də sənədləşdirilmiş struktur, avtomatlaşdırılmış test və etibarlı şəkildə müşahidə edilmiş canlı davranış arasında aydın şəkildə fərqləndirilməlidir.