சாட் விட்ஜெட்

இந்தக் குழு, வாடிக்கையாளர் இணையதளங்களில் பயன்படுத்தப்படும் அடங்கிய சேட் விடெட்ஜின் அனைத்து பொதுவான முனைகளையும் தொகுக்கிறது: அடைப்புத்திறன்ச் சரிபார்ப்பு (`GET /api/public/widget/health`), பொதுவான விடெட்ஜ் அமைப்பைப் பெறுதல் (`GET /api/public/widget/config/:widget_code`) மேலும் செய்தி அனுப்புதல் மற்றும் வரலாறு (`POST /api/public/widget/message`, `GET /api/public/widget/history`). விடெட்ஜ் உருவாக்கத்தின் போது தலைப்பாக்கம் அனுமதிக்கப்படுகிறது Zentor செய்து வைக்கப்பட்டது; இதற்கு குத்தகைதாரர்-டாஷ்போர்டில் எந்த அமைப்பு மேலாண்மைப் பகுதியும் இல்லை. ஒரு அனுமதிக்கப்படாத ஆதாரத்திற்கு ஏற்ப பிழை குறியீடு `WIDGET_ORIGIN_DENIED` எழலாம். விடெட் உருவாக்கம் மட்டுமே முக்கிய நிர்வாகியுக்கு மட்டுமே உரிமையாகும், அதே நேரத்தில் குத்தகைதாரர் முடிந்த ஊடுருவல் குறியீட்டைப் பெறுகிறது.

ஒரு பொதுவான வளர்ச்சியாளர்-API-கீ-அமைப்பு இல்லை. `health` மற்றும் `config` ஆகியவை அங்கீகாரமின்றி அணுகக்கூடியவை, ஏனெனில் இவை பிரவுசரில் விடெட்டைத் தொடங்குவதற்காக வடிவமைக்கப்பட்டுள்ளன. `message` மற்றும் `history` ஆகியவை மாறாக `X-Widget-Token` தலைப்பைத் தேவைப்படுத்துகின்றன மற்றும் கூடுதலாக சர்வர்-புறம் உள்ள ஆதிக்க அனுமதிப் பட்டியலுக்கு எதிராகச் சோதிக்கப்படுகின்றன. Embed-Token விடெட் உருவாக்கத்தின் போது ஒருமுறை தெளிவான உரையாகக் காட்டப்படுகிறது மற்றும் பொதுவான களஞ்சியங்கள், ஆதரவு-திரைப்படங்கள் அல்லது பிரவுசர்-திணைகளில் தோன்றக்கூடாது.

இந்தக் குழுவின் ஒவ்வொரு விவரத்திரும் தனித்தனியாக முறை, பாதை, அங்கீகாரம், ஐடிம்பாடென்சி மற்றும் அந்தத் தனித்தனி முடிப்பின் ஆவணப்படுத்தப்பட்ட பிழைக் குறியீடுகளை விவரிக்கிறது. ஒரு முனையம் வெற்றிகரமாக அழைக்கப்பட்டாலும், அது அதே குழுவில் உள்ள மற்றொரு முனையம் வெற்றிகரமாக இருந்தது என்பதைத் தானாக உறுதிப்படுத்தாது — குறிப்பாக, ஒரு பச்சை `health`-சரிபார்ப்பு ஒரு செல்லுபடியாகும் விடெட்டையும், அனுமதிக்கப்பட்ட ஆதிக்கத்தையும் அல்லது ஒரு AI கூட்டாளரின் அணுகலை உறுதிப்படுத்தாது.

இந்த உறுதிப்படுத்தப்பட்ட தளம்-அளவிலான API-எல்லை 15 நிமிடங்களில் 2,000 அனுப்புகளுக்குள் உள்ளது. ஒரு தனி விடெட்-முனையத்திற்கான எல்லைக்கு மாறுபாடு, அந்த முடிப்புக்காகத் தனித்தனியாக உறுதிப்படுத்தப்பட்டால் மட்டுமே குறிப்பிடப்படும். `message` ஐடிம்பாடெண்ட் அல்ல; ஒரு வாடிக்கையாளர் முதல் செய்தி ஏற்கனவே செயல்படுத்தப்பட்டதா என்பதைச் சரிபார்ப்பதற்கு முன், தவறாக நிறுத்தப்பட்ட அனுப்பு செயல்முறையைத் தானாக மீண்டும் செய்யக்கூடாது.

இந்தக் குழுவின் தொழில்நுட்பச் சோதனை `app/frontend/src/content/api-reference/groups/widget.ts` இல் உள்ள பதிவேட்டையும் தொடர்புடைய பின்னணி வழித்தடங்களையும் அடிப்படையாகக் கொண்டது. ஒவ்வொரு விரிவான பக்கமும், வெற்றிப் பாதை உயிர்ப்புமா, எதிர்மறைப் பாதையா அல்லது வெறும் குறியீட்டு ஒப்புமை மட்டுமா எனக் குறிப்பிடும்; இந்த வேறுபாடு முழுக் குழுவிற்கும் பொருந்தும், பொதுவான வெற்றி கூற்றுகளால் இதைப் பதிலிடக்கூடாது..