Widgeti i chat-it
Të gjitha pikat fundore që përdor widget-i i ngulitur i chat-it në faqet e klientëve.
Ky grup bashkon të gjitha pikat e fundit publike që widget-i i chat-it të integruar përdor në faqet e klientëve: kontrollin e disponueshmërisë (`GET /api/public/widget/health`), marrjen e konfigurimit publik të widget-it (`GET /api/public/widget/config/:widget_code`) si dhe dërgimin dhe historikun e mesazheve (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Lejimi i domenit menaxhohet gjatë krijimit të widget-it nga Zentor; nuk ekziston asnjë ndërfaqe konfigurimi në panelin e tenantit. Në rastin e një origjine jo të lëshuar, mund të shfaqet Kodi i gabimit `WIDGET_ORIGIN_DENIED`. Krijimi i vetë widget-it është i rezervuar për Master-Adminin, ndërsa tenanti merr kodin e integruar të gatshëm.
Nuk ekziston një sistem i përgjithshëm i çelësit të zhvilluesit API. `health` dhe `config` janë të aksesueshme pa autentifikim, pasi janë të destinuara për inicializimin e widget-it në shfletues. `message` dhe `history` kërkojnë në të kundërt kryesin `X-Widget-Token` dhe verifikohen shtesësisht kundër një listës leje Origjine server-side. Embed-Tokeni shfaqet një herë në tekst të pastër gjatë krijimit të widget-it dhe nuk duhet të shfaqet në repozitorët publikë, screenshot-et e mbështetjes ose logjet e shfletuesit.
Çdo faqe detaje e kësaj grupe përshkruan metodën, rrugën, autentifikimin, idempotencën dhe kodet e gabimit të dokumentuara të secilit pikë të fundit veç e veç. Një thirrje e suksesshme e një pike të fundit nuk garanton automatikisht se një pikë tjetër e grupit të njëjtë ka qenë e suksesshme — veçanërisht, një kontroll i gjelbër `health` nuk konfirmon asnjë widget të vlefshëm, as një origjinë të lëshuar, as aksesin te një ofrues AI.
Kufiri i konfirmuar platformor API është 2.000 kërkesa brenda 15 minutave. Një kufi i ndryshëm për një pikë të vetme widgeti përmendet vetëm nëse është specifikisht dokumentuar për atë pikë. `message` nuk është idempotent; një klient nuk duhet të ripërsërisë automatikisht një proces dërgimi të ndërprerë në mënyrë të paqartë, pa kontrolluar më parë nëse mesazhi i parë është tashmë i përpunuar.
Vërtetimi teknik i kësaj grupe bazohet në regjistrin në `app/frontend/src/content/api-reference/groups/widget.ts` dhe rrugët e pasme të lidhura. Çdo faqe detaje shënon nëse një rrugë e suksesshme është e aktivizuar, një rrugë negative ose nëse është verifikuar vetëm një analogji kodi — kjo dallim vlen për të gjithë grupin dhe nuk duhet të zëvendësohet me deklaratë të përgjithshme të suksesshme.