Çat vidceti
Müştəri veb-saytlarında yerləşdirilmiş chat vidcetinin istifadə etdiyi bütün endpointlər.
Bu qrup müştəri veb-saytlarında quraşdırılmış chat vidjetinin istifadə etdiyi bütün ictimai endpointləri birləşdirir: əlçatanlıq yoxlaması (`GET /api/public/widget/health`), ictimai vidjet konfiqurasiyasının əldə edilməsi (`GET /api/public/widget/config/:widget_code`), həmçinin mesaj göndərilməsi və tarixçə (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Domen icazəsi vidjet yaradılarkən Zentor tərəfindən idarə olunur; bunun üçün tenant panelində parametr interfeysi yoxdur. İcazə verilməmiş mənşə olduqda `WIDGET_ORIGIN_DENIED` xəta kodu baş verə bilər. Vidjet yaradılmasının özü yalnız master-adminə məxsusdur, tenant isə hazır yerləşdirmə kodunu alır.
Ümumi tərtibatçı API açarı sistemi mövcud deyil. `health` və `config` autentifikasiya olmadan əldə edilə bilər, çünki onlar vidjetin brauzerdə işə salınması üçün nəzərdə tutulub. `message` və `history` isə `X-Widget-Token` başlığını tələb edir və əlavə olaraq server tərəfli mənşə icazə siyahısına qarşı yoxlanılır. Embed token vidjet yaradılarkən bir dəfə açıq mətndə göstərilir və ictimai repozitoriyalarda, dəstək skrinşotlarında və ya brauzer jurnallarında görünməməlidir.
Bu qrupun hər bir detal səhifəsi metod, yol, autentifikasiya, idempotentlik və müvafiq endpointin sənədləşdirilmiş xəta kodlarını ayrıca təsvir edir. Bir endpointin uğurlu çağırışı avtomatik olaraq eyni qrupdakı digər endpointin də uğurlu olacağını sübut etmir — xüsusilə yaşıl `health` yoxlaması nə etibarlı vidjeti, nə icazə verilmiş mənşəyi, nə də KI provayderinin əlçatanlığını təsdiqləyir.
Təsdiqlənmiş platforma miqyaslı API limiti 15 dəqiqə ərzində 2.000 sorğudur. Fərdi vidjet endpointi üçün bundan fərqli limit yalnız həmin endpoint üçün açıq şəkildə sübut edildikdə qeyd olunur. `message` idempotent deyil; müştəri aydın olmayan şəkildə kəsilmiş göndərmə əməliyyatını ilk mesajın artıq işləndiyini yoxlamadan avtomatik təkrarlamamalıdır.
Bu qrupun texniki yoxlanışı `app/frontend/src/content/api-reference/groups/widget.ts` altındakı registrə və müvafiq backend marşrutlarına əsaslanır. Hər detal səhifəsi uğur yolunun canlı, mənfi yolun və ya yalnız kod analoqunun yoxlanıldığını qeyd edir — bu fərq bütün qrup üçün keçərlidir və ümumi uğur ifadələri ilə əvəz edilə bilməz.