Chat-modul
Minden végpont, amely a beágyazott csevegőmodult használja az ügyfélweboldalakon.
Ez a csoport az összes nyilvános végpontot gyűjti össze, amelyeket a beágyazott csevegőmodul a ügyfélweboldalakon használ: az elérhetőség-ellenőrzést (`GET /api/public/widget/health`), a nyilvános modul-konfiguráció lekérdezését (`GET /api/public/widget/config/:widget_code`), valamint az üzenetküldést és az üzenetelőzményeket (`POST /api/public/widget/message`, `GET /api/public/widget/history`). A domainmegosztást a modul létrehozásakor a Zentor kezeli; ehhez nincs beállítási felület a Tenant-dashbordon. Ha az eredet nincs megosztva, előfordulhat a `WIDGET_ORIGIN_DENIED` hibakód. A modul létrehozása a főadminisztrátorok kiváltsága, míg a tenant a kész beágyazó kódot kapja meg.
Nem létezik általános fejlesztői API-kulcs-rendszer. A `health` és a `config` végpontok hitelesítés nélkül elérhetők, mivel a modul böngészőben történő inicializálására szolgálnak. Ezzel szemben a `message` és a `history` végpontokhoz `X-Widget-Token` fejléc szükséges, és ezeket egy szerveroldali eredet-engedélyezési lista ellenőrzése is kiegészíti. Az embed-token a modul létrehozásakor egyszer jelenik meg tiszta szövegben, és nem szabad nyilvános tárolókban, támogatási képernyőképeken vagy böngészőnaplókban szerepelnie.
Minden részletes oldal ezen a csoporton belül egyenként ismerteti a módszer, az elérési út, a hitelesítés, az idempotencia és a dokumentált hibakódok vonatkozásait az adott végpontra. Egy végpont sikeres hívása nem jelenti automatikusan azt, hogy ugyanannak a csoportnak egy másik végpontja is sikeresen futna – különösen egy zöld `health`-ellenőrzés sem igazol érvényes modult, megosztott eredetet vagy egy AI-szolgáltató elérhetőségét.
A platformon érvényes API-korlát 2 000 kérelem 15 percen belül. Egyetlen modulvégpontra vonatkozó eltérő korlát csak akkor kerül megemlítésre, ha az kifejezetten igazolt az adott végpontra. A `message` nem idempotens; egy kliens nem ismételheti meg automatikusan egy egyértelműen megszakadt küldési műveletet anélkül, hogy előzetesen ellenőrizné, hogy az első üzenet már feldolgozásra került-e.
Ez a csoport technikai ellenőrzése az `app/frontend/src/content/api-reference/groups/widget.ts` registry-re és a hozzá tartozó backend-routákra támaszkodik. Minden részletes oldal jelzi, hogy egy sikeres útvonal élő tesztelése, egy negatív útvonal vagy csak egy kód-analógia ellenőrzése történt-e – ez a megkülönböztetés az egész csoportra érvényes, és nem helyettesíthető általános sikerállítással.