च्याट विजेट
सबै अन्त बिन्दुहरु जुन ग्राहकको वेबसाइटमा इम्बेडेड च्याट विजेटले प्रयोग गर्दछ।
यस समूहले ग्राहक वेबसाइटहरूमा प्रयोग हुने इम्बेड गरिएको Chat-Widget ले उपयोग गर्ने सबै सार्वजनिक एन्डपोइन्टहरूलाई एकसाथ राख्छ: पहुँच योग्यता जाँच (`GET /api/public/widget/health`), सार्वजनिक Widget कन्फिगरेसन प्राप्त गर्ने (`GET /api/public/widget/config/:widget_code`) साथै सन्देश पठाउने र इतिहास (`POST /api/public/widget/message`, `GET /api/public/widget/history`)। डोमेन स्वीकृति Widget सिर्जना गर्दा Zentor ले नै व्यवस्थापन गर्दछ; यसका लागि किरायेदार-ड्यासबोर्डमा कुनै सेटिङ इन्टरफेस छैन। स्वीकृत नभएको स्रोतबाट अनुरोध आएमा त्रुटि कोड `WIDGET_ORIGIN_DENIED` देखा पर्न सक्छ। Widget सिर्जना आफैं मास्टर-एडमिनका लागि सुरक्षित छ, जबकि किरायेदारले तयार इम्बेड कोड मात्र प्राप्त गर्छ।
सामान्य डेभलपर API-कुञ्जी प्रणाली अवस्थित छैन। `health` र `config` प्रमाणीकरण बिना नै पहुँचयोग्य छन्, किनभने ती ब्राउजरमा Widget सुरुआत गर्नका लागि बनाइएका हुन्। यसको विपरीत, `message` र `history` लाई `X-Widget-Token` हेडर चाहिन्छ र थप रूपमा सर्भर-साइड Origin एलाउलिस्टविरुद्ध जाँचिन्छ। Embed-Token Widget सिर्जना गर्दा एक पटक मात्र स्पष्ट पाठमा देखाइन्छ र सार्वजनिक रिपोजिटरी, सपोर्ट स्क्रिनसट वा ब्राउजर लगमा देखा पर्नु हुँदैन।
यस समूहको प्रत्येक विवरण पृष्ठले सम्बन्धित एन्डपोइन्टको विधि, पथ, प्रमाणीकरण, आइडेम्पोटेन्सी र दस्ताबेजीकृत त्रुटि कोडहरू छुट्टाछुट्टै वर्णन गर्दछ। एउटा एन्डपोइन्टको सफल कलले स्वतः यो प्रमाणित गर्दैन कि उही समूहको अर्को एन्डपोइन्ट पनि सफल हुनेछ — विशेष गरी हरियो `health` जाँचले न त वैध Widget, न स्वीकृत Origin, न त कुनै KI प्रदायकको उपलब्धता नै पुष्टि गर्छ।
प्रमाणित प्लेटफर्म-व्यापी API सीमा 15 मिनेटभित्र 2,000 अनुरोध हो। कुनै एकल Widget एन्डपोइन्टका लागि यसभन्दा फरक सीमा तब मात्र उल्लेख गरिन्छ जब त्यो सीमा उक्त एन्डपोइन्टका लागि स्पष्ट रूपमा प्रमाणित भएको छ। `message` आइडेम्पोटेन्ट होइन; क्लाइन्टले अस्पष्ट रूपमा रोकिएको पठाइ प्रक्रिया स्वतः दोहोर्याउनु हुँदैन, पहिलो सन्देश पहिले नै प्रशोधन भइसकेको छ कि छैन भनी जाँच नगरी।
यस समूहको प्राविधिक जाँच `app/frontend/src/content/api-reference/groups/widget.ts` अन्तर्गतको रजिस्ट्री र सम्बन्धित ब्याकइन्ड रूटहरूमा आधारित हुन्छ। प्रत्येक विवरण पृष्ठले सफलताको मार्ग Live मा जाँचिएको हो, नकारात्मक मार्ग हो, वा केवल कोड-समानता मात्र हो भनी चिन्ह लगाउँछ — यो भिन्नता सम्पूर्ण समूहमा लागू हुन्छ र सामान्यीकृत सफलताको दाबीले प्रतिस्थापन गर्नु हुँदैन।