Iwijethi yencoko
Zonke iindawo zokugqibela ezisetyenziswa yiwijethi yencoko efakelweyo kwiiwebhusayithi zabathengi.
Eli qela liqokelela zonke iindawo zokuphela zoluntu ezisetyenziswa yi-chat-widget efakwe kwiiwebhusayithi zabathengi: uhlolo lokufikeleleka (`GET /api/public/widget/health`), ukufumana uqwalaselo lwe-widget yoluntu (`GET /api/public/widget/config/:widget_code`) kunye nokuthumela nembali yemiyalezo (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Imvume yedomeyini igcinwa yi-Zentor xa kusenziwa i-widget; akukho jongano lwezicwangciso kwi-dashboard ye-tenant. Xa imvelaphi ingavunywanga, kunokuvela ikhowudi yempazamo `WIDGET_ORIGIN_DENIED`. Ukwenziwa kwe-widget ngokwako kugcinelwe i-Master-Admin, ngelixa i-tenant ifumana ikhowudi yokufaka egqityiweyo.
Inkqubo jikelele yezitshixo ze-API zabaphuhlisi ayikho. I-`health` ne-`config` ziyafikeleleka ngaphandle kokuqinisekiswa kwesazisi, kuba zenzelwe ukuqaliswa kwe-widget kwibhrawuza. I-`message` ne-`history` zona zifuna i-header ye-`X-Widget-Token` kwaye zihlolwa ngokongezelelweyo ngokuchasene noluhlu lwee-Origin ezivunyiweyo kwiseva. I-Embed-Token iboniswa kanye ngombhalo ocacileyo xa kusenziwa i-widget kwaye akufuneki ivele kwii-repository zoluntu, kwiiskrini zenkxaso okanye kwiilogi zebhrawuza.
Iphepha leenkcukacha ngalinye leli qela lichaza indlela, indlela yendlela, ukuqinisekiswa kwesazisi, i-idempotency neekhowudi zeempazamo ezibhaliweyo zendawo yokuphela nganye ngokwahlukileyo. Ukubizwa ngempumelelo kwendawo yokuphela enye akungqini ngokuzenzekelayo ukuba enye indawo yokuphela yeli qela nayo ibinokuphumelela — ngakumbi, uhlolo oluluhlaza lwe-`health` aluqinisekisi i-widget esebenzayo, i-Origin evunyiweyo okanye ukufikeleleka komboneleli we-AI.
Umda we-API oqinisekisiweyo weqonga lonke zizicelo ezi-2.000 kwisithuba semizuzu eli-15. Umda owahlukileyo wendawo yokuphela ye-widget ethile ukhankanywa kuphela ukuba ungqinwe ngokucacileyo kuloo ndawo yokuphela. I-`message` ayiyiyo idempotent; umthengi-software akufuneki aphinde ngokuzenzekelayo ukuthumela okuyekileyo ngokungacacanga, ngaphandle kokuqala ahlole ukuba umyalezo wokuqala sele uqhutyiwe na.
Uhlolo lobuchwepheshe leli qela luxhomekeke kwi-Registry ephantsi kwe-`app/frontend/src/content/api-reference/groups/widget.ts` nakwiindlela ze-backend ezinxulumeneyo. Iphepha leenkcukacha ngalinye liphawula ukuba kuhlolwe indlela yempumelelo ephilayo, indlela engalunganga okanye ukufana kwekhowudi kuphela — lo mahluko usebenza kwiqela lonke kwaye akufuneki uthathelwe indawo ziingxelo jikelele zempumelelo.