ग्राहक webhook कॉन्फ़िगर करें

समर्थित ग्राहक events

ग्राहक फ़ॉर्म में job finished, invoice issued और quota threshold events उपलब्ध हैं। केवल वही चुनें जिन्हें आपका receiver संभालता हो। Endpoint आपके व्यक्तिगत या चुने संगठन संदर्भ में रहता है। संगठन owner और administrator प्रबंधित कर सकते हैं; सदस्य देख सकते हैं पर बदल नहीं सकते। Webhook सूचना भेजता है, ऑर्डर या इनवॉइस नहीं बदलता।

1. इच्छित संगठन संदर्भ में Webhooks खोलें।
2. Receiver द्वारा समर्थित कम-से-कम एक event चुनें।
3. अलग-अलग परिवेशों के लिए अलग endpoints रखें।

सार्वजनिक destination दर्ज करें

Endpoint बनाने के लिए 2–120 वर्ण का नाम, मान्य URL और एक या अधिक सूचीबद्ध events चाहिए। HTTPS और सार्वजनिक hostname आवश्यक हैं। Local, internal और private IP destinations अस्वीकृत होते हैं, इसलिए विकास का स्थानीय URL काम नहीं करेगा। Receiver JSON स्वीकार कर सफल HTTP उत्तर देने लगे तभी जमा करें।

1. स्थिर सार्वजनिक HTTPS पते पर receiver तैनात करें।
2. URL, स्पष्ट नाम और event चयन भरें।
3. एक बार जमा करें और validation त्रुटियाँ ठीक करें।

हस्ताक्षरित संदेश जाँचें

बनाते समय signing secret एक बार दिखता है। अनुरोधों में event, delivery, timestamp और HMAC signature headers तथा event ID, type, creation time और data वाला JSON होता है। Timestamp और हूबहू raw body पर signature जाँचें, उचित timestamp अवधि लागू करें और duplicate IDs को idempotent ढंग से सँभालें। Secret लॉग या सहायता संदेश में न रखें।

1. Secret को receiver के सुरक्षित configuration में रखें।
2. बदले बिना प्राप्त request body के विरुद्ध signature जाँचें।
3. व्यावसायिक कार्रवाई दोहरने से रोकने को event IDs दर्ज करें।

Delivery इतिहास पढ़ें

पृष्ठ आपके endpoints की हाल की 50 deliveries दिखाता है। सफल HTTP उत्तर को succeeded माना जाता है। Server errors और rate limits पर फिर प्रयास हो सकता है; अन्य असफल उत्तर तुरंत fail हो सकते हैं और सीमा के बाद प्रयास रुक जाते हैं। इतिहास में response status और सीमित response body या error दिखते हैं। Event न हुआ हो या endpoint ने उसे चुना न हो तो वह दिखाई नहीं देगा।

1. Event, प्रयास संख्या, स्थिति और आखिरी त्रुटि देखें।
2. Receiver उपलब्धता, response या rate limiting ठीक करें।
3. बाद की delivery में succeeded स्थिति की पुष्टि करें।

Signing secret बदलें

Rotation endpoint का secret बदलकर उसे फिर सक्रिय करता है। केवल पुरानी value इस्तेमाल करने वाले receivers नए अनुरोध अस्वीकार करेंगे। Receiver configuration अपडेट की तैयारी करें, सही endpoint पंक्ति से rotate करें, नया मान सुरक्षित रखें और शीघ्र deploy करें। समझौता होने पर तुरंत बदलें और अनपेक्षित गतिविधि के लिए delivery इतिहास देखें।

1. Receiver instances पहचानकर सुरक्षित deployment तैयार करें।
2. Endpoint rotate करें और एक बार दिखा secret सुरक्षित रखें।
3. अगली अपेक्षित delivery के सफल होने की पुष्टि करें।

Endpoint बदलें या रद्द करें

ग्राहक endpoint बना, rotate और revoke कर सकते हैं; URL या event चयन बदलने का edit विकल्प नहीं है। बदलाव के लिए replacement बनाएँ, सही events मिलने की पुष्टि करें, फिर पुराना endpoint रद्द करें। Revocation आगे की deliveries रोकता और उसे inactive करता है। पुराने destination या उजागर secret के लिए यही तरीका अपनाएँ और कार्रवाई के बाद सूची जाँचें।

1. सही URL या event समूह के साथ replacement बनाएँ।
2. उस पर delivery सफल होने की पुष्टि करें।
3. पुराना endpoint revoke करें और inactive स्थिति जाँचें।

अक्सर पूछे जाने वाले प्रश्न

संबंधित पृष्ठ

• ऑर्डर से पहले कीमत समझें
• ग्राहक ऑर्डर दें और उनकी स्थिति देखें
• सदस्यताएँ और बिलिंग देखें
• API कुंजियाँ बनाएँ और सुरक्षित रखें
• संगठन की सदस्यता सँभालें
• सूचनाएँ प्रबंधित करें
• Profile, सुरक्षा और गोपनीयता सँभालें