Wijeti ya chat

Kundi hili linakusanya endpoints zote za umma zinazotumiwa na wijeti ya chat iliyopachikwa kwenye tovuti za wateja: ukaguzi wa upatikanaji (`GET /api/public/widget/health`), upatikanaji wa usanidi wa umma wa wijeti (`GET /api/public/widget/config/:widget_code`) pamoja na kutuma ujumbe na historia ya ujumbe (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Uidhinishaji wa domain hudumishwa na Zentor wakati wa kuunda wijeti; hakuna kiolesura cha mipangilio kwa hili kwenye Dashboard ya mpangaji. Ikiwa chanzo (origin) hakijaidhinishwa, msimbo wa hitilafu `WIDGET_ORIGIN_DENIED` unaweza kutokea. Kuunda wijeti yenyewe ni kazi ya Master-Admin pekee, huku mpangaji akipokea msimbo wa kupachika uliokamilika.

Hakuna mfumo wa jumla wa API Key kwa wasanidi programu. `health` na `config` zinapatikana bila uthibitishaji wa utambulisho kwa sababu zimekusudiwa kuanzisha wijeti kwenye kivinjari. Kwa upande mwingine, `message` na `history` zinahitaji kichwa (header) cha `X-Widget-Token` na pia hukaguliwa dhidi ya orodha ya origins zinazoruhusiwa (allowlist) upande wa seva. Tokeni ya kupachika huonyeshwa kwa maandishi wazi mara moja tu wakati wa kuunda wijeti na haipaswi kuonekana kwenye hazina (repositories) za umma, picha za skrini za msaada wala kumbukumbu (logs) za kivinjari.

Kila ukurasa wa maelezo ya kina wa kundi hili unaeleza kando mbinu, njia, uthibitishaji wa utambulisho, idempotency na misimbo ya hitilafu iliyoandikwa ya endpoint husika. Wito uliofaulu wa endpoint moja hauthibitishi kiotomatiki kwamba endpoint nyingine ya kundi hilohilo nayo ingefaulu — hasa, ukaguzi wa `health` wenye matokeo ya kijani hauthibitishi wijeti halali, origin iliyoidhinishwa wala upatikanaji wa mtoa huduma wa AI.

Kikomo cha API kilichothibitishwa kwa jukwaa zima ni maombi 2.000 ndani ya dakika 15. Kikomo tofauti kwa endpoint moja ya wijeti hutajwa tu ikiwa kimethibitishwa waziwazi kwa endpoint hiyo. `message` si idempotent; client hapaswi kurudia kiotomatiki utumaji uliokatizwa kwa njia isiyo wazi bila kwanza kukagua kama ujumbe wa kwanza tayari umechakatwa.

Ukaguzi wa kiufundi wa kundi hili unategemea sajili (registry) iliyo chini ya `app/frontend/src/content/api-reference/groups/widget.ts` na njia (routes) husika za backend. Kila ukurasa wa maelezo ya kina unaonyesha kama njia ya mafanikio ilikaguliwa moja kwa moja (live), kama njia hasi ilikaguliwa, au kama ni ulinganisho wa msimbo tu — tofauti hii inatumika kwa kundi zima na haipaswi kubadilishwa na kauli za jumla za mafanikio.