जानने योग्य बातें - Webhook सीमाएँ और सिस्टम व्यवहार

यह समझना कि finlight webhook त्रुटियों, पुनः प्रयासों और सीमाओं को कैसे संभालता है, आपको अधिक विश्वसनीय एकीकरण बनाने और अपने कोटा को प्रभावी ढंग से प्रबंधित करने में मदद करता है।

त्रुटि प्रबंधन और पुनः प्रयास

पुनः प्रयास तर्क

जब कोई webhook डिलीवरी विफल होती है, तो finlight स्वतः अनुरोध का पुनः प्रयास करता है:

पुनः प्रयास अनुसूची:

• पहला पुनः प्रयास: प्रारंभिक विफलता के तुरंत बाद
• दूसरा पुनः प्रयास
• तीसरा पुनः प्रयास

अधिकतम प्रयास:

• प्रति webhook इवेंट कुल 3 डिलीवरी प्रयास
• प्रत्येक पुनः प्रयास समान पेलोड और हेडर का उपयोग करता है
• सभी पुनः प्रयास आपके कॉल इतिहास में लॉग किए जाते हैं

पुनः प्रयास किससे ट्रिगर होते हैं

पुनः प्रयास इन स्थितियों में होते हैं:

• HTTP त्रुटि कोड 4xx और 5xx प्रतिक्रियाएँ
• नेटवर्क टाइमआउट (5 सेकंड सीमा)
• कनेक्शन विफलताएँ (DNS त्रुटियाँ, अस्वीकृत कनेक्शन)
• SSL/TLS त्रुटियाँ (प्रमाणपत्र समस्याएँ)

पुनः प्रयास किससे ट्रिगर नहीं होते

इन स्थितियों में कोई पुनः प्रयास नहीं:

• HTTP 2xx प्रतिक्रियाएँ (सफल मानी जाती हैं)
• अमान्य webhook कॉन्फ़िगरेशन (त्रुटिपूर्ण URL)
• अक्षम किए गए webhook

ऑटो-डिसेबल सुरक्षा

लगातार विफलता ट्रैकिंग

finlight आपके कोटा की रक्षा और अंतहीन विफल प्रयासों को रोकने के लिए लगातार webhook विफलताओं को ट्रैक करता है।

यह कैसे काम करता है:

1. सफलता काउंटर रीसेट करती है - कोई भी सफल डिलीवरी (HTTP 2xx) विफलता काउंटर को 0 पर रीसेट कर देती है
2. विफलताएँ काउंटर बढ़ाती हैं - प्रत्येक विफल डिलीवरी लगातार विफलता गिनती बढ़ाती है
3. 10 पर ऑटो-डिसेबल - 10 लगातार विफलताओं के बाद, webhook स्वतः अक्षम हो जाता है

ऑटो-डिसेबल व्यवहार

ऑटो-डिसेबल कब ट्रिगर होता है:

• सभी पुनः प्रयासों में 10 लगातार विफल डिलीवरी
• webhook की स्थिति "सक्षम" से "अक्षम" में बदल जाती है
• ऑटो-डिसेबल दर्शाने वाली डैशबोर्ड सूचना दिखाई देती है
• मैन्युअल रूप से पुनः सक्षम करने तक कोई और webhook प्रयास नहीं

महत्वपूर्ण नोट्स:

• ऑटो-डिसेबल के लिए केवल लगातार विफलताएँ गिनी जाती हैं
• कोई भी सफल डिलीवरी काउंटर को 0 पर रीसेट कर देती है
• मैन्युअल पुनः सक्षम करना आवश्यक - webhook स्वतः सक्षम नहीं होते
• सभी विफलता प्रकार गिने जाते हैं (टाइमआउट, 4xx, 5xx प्रतिक्रियाएँ)

उदाहरण परिदृश्य

परिदृश्य 1: काउंटर रीसेट

Attempt 1: Failed (counter = 1)
Attempt 2: Failed (counter = 2)
Attempt 3: Success (counter = 0) ← Reset!
Attempt 4: Failed (counter = 1)

परिदृश्य 2: ऑटो-डिसेबल

Attempts 1-10: All failed (counter = 10)
→ Webhook automatically disabled

पुनर्प्राप्ति और पुनः सक्षम करना

मैन्युअल पुनः सक्षम करने की प्रक्रिया

पुनः सक्षम करने के चरण:

1. कॉल इतिहास का उपयोग करके मूल कारण की पहचान करें
2. एंडपॉइंट समस्याएँ ठीक करें (प्रमाणीकरण, URL, सर्वर त्रुटियाँ)
3. स्थिति सेटिंग संपादित करके webhook विवरण में webhook को पुनः सक्षम करें
4. डैशबोर्ड परीक्षण बटन का उपयोग करके webhook का मैन्युअल परीक्षण करें
5. समाधान की पुष्टि के लिए प्रारंभिक डिलीवरी की निगरानी करें

रोकथाम रणनीतियाँ

ऑटो-डिसेबल से बचें:

• अपने एंडपॉइंट में उचित त्रुटि प्रबंधन लागू करें
• उपयुक्त HTTP स्टेटस कोड लौटाएँ
• webhook स्वास्थ्य की सक्रिय रूप से निगरानी करें
• webhook विफलताओं के लिए अलर्ट सेट करें
• उत्पादन से पहले विकास में परिवर्तनों का परीक्षण करें

कोटा प्रबंधन

आप डैशबोर्ड पर ग्राफ़ में अपना उपयोग देख सकते हैं। ध्यान रखें कि उपयोग विलंब से रिकॉर्ड किया जाता है।

विफल अनुरोध कोटा में गिने जाते हैं

महत्वपूर्ण: विफल डिलीवरी सहित सभी webhook डिलीवरी प्रयास आपके सब्सक्रिप्शन कोटा में गिने जाते हैं।

क्या गिना जाता है:

• प्रारंभिक डिलीवरी प्रयास - कोटा में गिने जाते हैं
• सभी पुनः प्रयास - प्रत्येक पुनः प्रयास अलग से गिना जाता है
• विफल डिलीवरी - फिर भी कोटा की खपत करती हैं
• webhook परीक्षण अनुरोध - ये भी कोटा में गिने जाते हैं

कोटा प्रभाव उदाहरण:

1 webhook event with 5 failed retry attempts = 5 quota usage
1 webhook event with 1 successful delivery = 1 quota usage

कोटा को कुशलता से प्रबंधित करना

सर्वोत्तम प्रथाएँ:

• विफल पुनः प्रयासों को कम करने के लिए एंडपॉइंट समस्याओं को शीघ्र ठीक करें
• विफलता पैटर्न के लिए कॉल इतिहास की निगरानी करें
• उत्पादन में webhook सक्षम करने से पहले अच्छी तरह परीक्षण करें
• उपयुक्त स्टेटस कोड लौटाने के लिए उचित त्रुटि प्रबंधन का उपयोग करें

कोटा सुरक्षा: ऑटो-डिसेबल सुविधा लगातार विफल होने वाले एंडपॉइंट पर डिलीवरी रोककर कोटा की बर्बादी को रोकने में मदद करती है।

webhook सेटअप मार्गदर्शन के लिए, मुख्य webhooks दस्तावेज़ देखें। परीक्षण और डिबगिंग के लिए, परीक्षण गाइड देखें।