Widget de chat
Toate endpointurile pe care le utilizează widgetul de chat încorporat pe site-urile clienților.
Acest grup reunește toate endpointurile publice pe care le folosește widgetul de chat încorporat pe site-urile web ale clienților: verificarea disponibilității (`GET /api/public/widget/health`), preluarea configurației publice a widgetului (`GET /api/public/widget/config/:widget_code`), precum și trimiterea și istoricul mesajelor (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Aprobarea domeniului este gestionată de Zentor la crearea widgetului; pentru aceasta nu există o interfață de setări în panoul de control al tenantului. În cazul unei origini neaprobate poate apărea codul de eroare `WIDGET_ORIGIN_DENIED`. Crearea widgetului în sine este rezervată administratorului principal (Master-Admin), în timp ce tenantul primește codul de încorporare gata de utilizare.
Nu există un sistem general de chei API pentru dezvoltatori. `health` și `config` sunt accesibile fără autentificare, deoarece sunt destinate inițializării widgetului în browser. `message` și `history`, în schimb, necesită antetul `X-Widget-Token` și sunt verificate suplimentar față de o listă de origini permise (allowlist) pe server. Tokenul de încorporare este afișat o singură dată în text clar la crearea widgetului și nu trebuie să apară în depozite publice, capturi de ecran pentru suport sau jurnale de browser.
Fiecare pagină de detalii a acestui grup descrie individual metoda, calea, autentificarea, idempotența și codurile de eroare documentate ale endpointului respectiv. Un apel reușit al unui endpoint nu dovedește automat că un alt endpoint din același grup ar fi reușit la rândul lui — în special, un control `health` verde nu confirmă nici un widget valid, nici o origine aprobată, nici disponibilitatea unui furnizor de IA.
Limita API confirmată la nivel de platformă este de 2.000 de solicitări în interval de 15 minute. O limită diferită pentru un singur endpoint de widget este menționată numai dacă este dovedită explicit pentru acel endpoint. `message` nu este idempotent; un client nu are voie să repete automat o trimitere întreruptă în mod neclar fără a verifica mai întâi dacă primul mesaj a fost deja procesat.
Verificarea tehnică a acestui grup se bazează pe registrul din `app/frontend/src/content/api-reference/groups/widget.ts` și pe rutele backend aferente. Fiecare pagină de detalii indică dacă a fost verificată o cale de succes live, o cale negativă sau doar o analogie de cod — această distincție se aplică întregului grup și nu poate fi înlocuită cu afirmații generale de succes.