Chat widget
Všetky koncové body, ktoré využíva vložený chat widget na webových stránkach zákazníkov.
Táto skupina združuje všetky verejné koncové body, ktoré vložený chat widget používa na webových stránkach zákazníkov: kontrolu dostupnosti (`GET /api/public/widget/health`), získanie verejnej konfigurácie widgetu (`GET /api/public/widget/config/:widget_code`) a odosielanie správ a históriu (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Povolenie domény spravuje Zentor pri vytvorení widgetu; v dashboarde tenanta preň neexistuje žiadne rozhranie nastavení. Pri nepovolenom pôvode (origin) sa môže vyskytnúť chybový kód `WIDGET_ORIGIN_DENIED`. Samotné vytvorenie widgetu je vyhradené Master-Adminovi, zatiaľ čo tenant dostane hotový kód na vloženie.
Všeobecný systém vývojárskych kľúčov API neexistuje. `health` a `config` sú dostupné bez autentifikácie, pretože sú určené na inicializáciu widgetu v prehliadači. `message` a `history` naopak vyžadujú hlavičku `X-Widget-Token` a navyše sa kontrolujú voči allowliste pôvodov na strane servera. Embed token sa pri vytvorení widgetu zobrazí iba raz v čitateľnom tvare a nesmie sa objaviť vo verejných repozitároch, screenshotoch pre podporu ani v logoch prehliadača.
Každá podrobná stránka tejto skupiny samostatne opisuje metódu, cestu, autentifikáciu, idempotenciu a zdokumentované chybové kódy príslušného koncového bodu. Úspešné volanie jedného koncového bodu automaticky nepreukazuje, že by rovnako úspešne prebehol iný koncový bod tej istej skupiny – najmä zelená kontrola `health` nepotvrdzuje ani platný widget, ani povolený origin, ani dostupnosť poskytovateľa AI.
Potvrdený limit API pre celú platformu je 2.000 požiadaviek za 15 minút. Odlišný limit pre jednotlivý koncový bod widgetu sa uvádza len vtedy, ak je pre tento koncový bod výslovne doložený. `message` nie je idempotentné; klient nesmie automaticky opakovať nejasne prerušené odoslanie bez toho, aby predtým overil, či už bola prvá správa spracovaná.
Technická kontrola tejto skupiny vychádza z registra v `app/frontend/src/content/api-reference/groups/widget.ts` a príslušných backendových ciest. Každá podrobná stránka uvádza, či bola overená úspešná cesta naživo, negatívna cesta alebo len analógia v kóde – toto rozlíšenie platí pre celú skupinu a nesmie sa nahradiť paušálnymi tvrdeniami o úspechu.