Widget chat.

Cuireann an grúpa seo le chéile gach ceann de na críochphointeanna poiblí, a úsáideann an widget chat cláraithe ar láithreoirí Gréasáin na cliaint: an seiceáil inacmhainne (`GET /api/public/widget/health`), an t-ionscrú na tríomhaíochtaí widget poiblí (`GET /api/public/widget/config/:widget_code`), chomh maith mar slí chuig teachtaireachtaí agus stair teachtaireachtaí (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Déantar bainistíocht an réimeach domain ag Zentor nuair a cruthaítear an widget; níl aon réimíocht le haghaidh sin sa painéal rialaithe an fhéideara. Má níl an tionscnamh ceadaithe, féadfaidh an cód briste `WIDGET_ORIGIN_DENIED` a bheith ann. Tá an cruthaíocht widget féin faoi úinéar an rialtóra príomh, agus faigheann an féideara an cód cláraithe críochnaithe.

Ní bhíonn aon chóras eochair API forbraitheoir ginearálta. Tá `health` agus `config` inrochtana gan faomhadh, mar go bhfuil siad deartha chun an widget a bhunú sa bróinn. Áfach, tá `message` agus `history` ag teastanas an ceannbriathar `X-Widget-Token` agus déantar seiceáil freisin orthu i gcoinne liosta ceadaithe tionscnaimh ar an gcomhshóisear. Léirítear an t-eochair cláraithe uair amháin i ndlúthbhriotán nuair a cruthaítear an widget, agus ní féidir é a bheith i measc na bhfoinsí poiblí, scáthánanna tacaíochta, nó loganna bróin.

Cuireann gach leathanach sonraíochta den grúpa seo síos an modh, an bpata, an faomhadh, an idemptence, agus na cóidí briste a dhoicimpeadh don gach críochphointe ar leith. Ní chiallaíonn glaoimh rathúil ar críochphointe amháin go dtéann gach críochphointe eile sa grúpa céanna go rathúil – go háirithe, ní dhearbhaíonn seiceáil glas `health` widget bhailí, tionscnamh ceadaithe, nó inacmhainne do sholáthraí AI.

Is é an teorainn API atá ceadaithe ar fud an phlátafoirm ná 2,000 iarratais laistigh de 15 nóiméad. Tá teorainn difriúil le haghaidh gach críochphointe widget amháin, ach ní luaítear é ach amháin má tá sé ceadaithe go díreach don críochphointe sin. Ní bhíonn `message` idemptent; ní féidir le cliant iarratais slíothachta a athrú go tapa gan a chinntiú go bhfuil an t-athrú tosnaithe cheadaithe.

Bunaithe ar an ríocht faoi `app/frontend/src/content/api-reference/groups/widget.ts` agus na bealaí cúnamh a bhaineann leis, tá an seiceáil teicniúil den grúpa seo. Léiríonn gach leathanach sonraíochta an bhfuil an bealach rathúil beo, an bealach diúltach, nó an cosaint cód amháin a rinneadh – tá an difear seo i bhfad níos fearr ná ráitis rath amhail.