I-widget yengxoxo

Leli qembu lihlanganisa wonke ama-endpoint omphakathi asetshenziswa yi-widget yengxoxo efakiwe kumawebhusayithi amakhasimende: ukuhlola ukufinyeleleka (`GET /api/public/widget/health`), ukulanda ukulungiselelwa komphakathi kwe-widget (`GET /api/public/widget/config/:widget_code`) kanye nokuthumela imilayezo nomlando (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Ukugunyazwa kwesizinda kunakekelwa yi-Zentor lapho kudalwa i-widget; ayikho indawo yezilungiselelo zalokhu ku-dashboard ye-tenant. Uma umsuka ungagunyaziwe, kungavela ikhodi yephutha `WIDGET_ORIGIN_DENIED`. Ukudala i-widget ngokwakho kugcinelwe i-Master-Admin, kuyilapho i-tenant ithola ikhodi yokufaka esilungile.

Ayikho isistimu ejwayelekile yokhiye be-API bonjiniyela. I-`health` ne-`config` ziyafinyeleleka ngaphandle kokuqinisekisa ubuwena, ngoba zihloselwe ukuqalisa i-widget esipheqululini. I-`message` ne-`history`, ngakolunye uhlangothi, zidinga i-header ethi `X-Widget-Token` futhi zihlolwa ngokwengeziwe ohlwini lwama-origin avunyelwe ohlangothini lweseva. I-embed token iboniswa kanye kuphela ngombhalo ocacile lapho kudalwa i-widget futhi akumele ivele kuma-repository omphakathi, kuma-screenshot osekelo noma kuma-log esiphequluli.

Ikhasi ngalinye lemininingwane kuleli qembu lichaza ngokwehlukana indlela, umzila, ukuqinisekisa ubuwena, i-idempotency namakhodi amaphutha abhaliwe e-endpoint ngayinye. Ukubiza okuphumelelayo kwe-endpoint eyodwa akufakazeli ngokuzenzakalelayo ukuthi enye i-endpoint yeqembu elifanayo nayo ingaphumelela — ikakhulukazi ukuhlola okuluhlaza kwe-`health` akuqinisekisi i-widget evumelekile, i-origin egunyaziwe noma ukufinyeleleka komhlinzeki we-AI.

Umkhawulo we-API oqinisekisiwe wenkundla yonke yizicelo ezingu-2.000 phakathi kwemizuzu engu-15. Umkhawulo ohlukile we-endpoint eyodwa ye-widget ubalulwa kuphela uma ufakazelwe ngokusobala kuleyo endpoint. I-`message` ayiyona i-idempotent; iklayenti akumele liphinde ngokuzenzakalelayo ukuthumela okuphazamiseke ngendlela engacacile ngaphandle kokuqala lihlole ukuthi umlayezo wokuqala usucutshunguliwe yini.

Ukuhlolwa kobuchwepheshe kwaleli qembu kusekelwe ku-registry ethi `app/frontend/src/content/api-reference/groups/widget.ts` nemizila ye-backend ehambisanayo. Ikhasi ngalinye lemininingwane liphawula ukuthi umzila wempumelelo uhlolwe bukhoma, umzila ongemuhle noma ukuqhathanisa kwekhodi kuphela — lokhu kuhlukanisa kusebenza eqenjini lonke futhi akumele kuthathelwe indawo yizitatimende ezijwayelekile zempumelelo.