خطافات الويب
تعلم حين يحدث الأمر، لا حين تسأل.
سجّل نقطة نهاية 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 دقيقة، ثم بعد ساعتين. وأي 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 عام فقط
تُرفض المضيفات الخاصة ومضيفات loopback، ولا تُتبع إعادة التوجيه أبداً.
كل محاولة مسجّلة
تُظهر كل واحدة بماذا ردّ خادمك وكم استغرق ذلك.
ممارسات جيدة
لتستفيد منه إلى أقصى حد
- 01
أجب أولاً، ثم اعمل
أعد 2xx خلال خمس ثوانٍ، وأنجز العمل البطيء بعدها.
- 02
أسقط المعرّفات المكررة
خزّن كل معرّف X-OpenEmail-Delivery تعالجه، وتخطَّ المكرر.
- 03
دوّر السر مع إبقاء الاثنين
التدوير يستبدل السر فوراً، فتحقق بالقديم والجديد معاً حتى يكتمل النشر لديك.
أسئلة
ما يُسأل عنه كثيرًا
تابع القراءة
يعمل جيدًا مع
ابدأ
نطاقك،
بريدك.
وجّه نطاقًا إلى OpenEmail واقرأ بريده في صندوق بريد مبنيّ حوله. الخطة المجانية تشمل نطاقًا واحدًا.
