वेबहुक
जब होता है तभी पता चलता है, पूछने पर नहीं।
एक https एंडपॉइंट रजिस्टर करें और मेल आने, जाने, बाउंस होने या खुलने पर साइन किया हुआ POST पाएँ।
संक्षेप में
ईमेल वेबहुक क्या है?
वेबहुक एक HTTP अनुरोध है जिसे कोई सेवा कुछ होने पर आपके URL पर भेजती है, ताकि आपका कोड बार-बार पूछने के बजाय तुरंत प्रतिक्रिया दे। ईमेल में इसका मतलब है मेल का आना, जाना, बाउंस होना या खुलना।
20
इवेंट जिन्हें सब्सक्राइब कर सकते हैं
10
एंडपॉइंट हर मेलबॉक्स पर
5
प्रयास हर इवेंट पर, अधिकतम
100
लगातार विफल इवेंट एंडपॉइंट बंद कर देते हैं
यह कैसे काम करता है
भेजने का हर तरीका, एक ही इवेंट
एडिटर, मंगलवार के लिए शेड्यूल किया गया भेजना और API, तीनों email.sent उठाते हैं। शेड्यूल करने पर पहले email.scheduled उठता है।
साइन किया हुआ, जाँच आपके हाथ
हर POST में टाइमस्टैम्प और रॉ बॉडी का HMAC-SHA-256 होता है। बाइट्स को वैसे ही जाँचें जैसे वे पहुँचे, और 300 सेकंड से पुरानी हर चीज़ अस्वीकार करें।
दोबारा प्रयास तभी, जब काम बन सके
टाइमआउट, 408, 425, 429 और 5xx पर 1, 5 और 25 मिनट बाद, फिर 2 घंटे बाद दोबारा प्रयास होता है। कोई भी दूसरा 4xx अंतिम है, और 410 एंडपॉइंट को बंद कर देता है।
तीन परिवारों में बीस इवेंट
कुछ भी न चुनें तो email.replied को छोड़कर हर संदेश इवेंट सब्सक्राइब हो जाता है।
डिलीवरी सत्यापित करें
SDK HMAC को कॉन्स्टेंट टाइम में जाँचता है और पाँच मिनट से पुरानी डिलीवरी अस्वीकार करता है।
import { verifyWebhookSignature } from '@openemail/sdk' export default async (request: Request) => { const event = await verifyWebhookSignature({ payload: await request.text(), headers: request.headers, secret: process.env.OPENEMAIL_WEBHOOK_SECRET! }) console.log(event.type, event.data) return new Response(null, { status: 204 })}आपको क्या मिलता है
आज प्रोडक्ट में
पाँच सेकंड, समानांतर
एंडपॉइंट एक साथ कॉल होते हैं, इसलिए दस भी पाँच सेकंड ही लेते हैं।
सिर्फ़ सार्वजनिक https
प्राइवेट और लूपबैक होस्ट अस्वीकार होते हैं, और रीडायरेक्ट कभी फ़ॉलो नहीं होता।
हर प्रयास दर्ज
हर एक में दिखता है कि आपके सर्वर ने क्या जवाब दिया और कितना समय लगा।
अच्छे तरीक़े
इसका पूरा फ़ायदा उठाएँ
- 01
पहले जवाब, फिर काम
पाँच सेकंड के भीतर 2xx लौटाएँ और धीमा काम बाद में करें।
- 02
दोहराई गई id छोड़ें
संभाली गई हर X-OpenEmail-Delivery id सहेजें और दोहराव छोड़ दें।
- 03
दोनों सीक्रेट के साथ रोटेट करें
रोटेशन सीक्रेट को तुरंत बदल देता है, इसलिए जब तक आपका डिप्लॉय न पहुँचे, पुराने और नए दोनों से सत्यापित करें।
सवाल
अक्सर पूछे जाते हैं
आगे पढ़ें
इनके साथ अच्छा चलता है
शुरू करें
आपका डोमेन,
आपका मेल।
किसी डोमेन को OpenEmail की ओर पॉइंट करें और उसका मेल उसी के इर्द-गिर्द बने मेलबॉक्स में पढ़ें। मुफ़्त प्लान में एक डोमेन शामिल है।
