وبهوکها
همان لحظه که رخ میدهد خبردار میشوید، نه وقتی بپرسید.
یک نقطه پایانی 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 عمومی
میزبانهای خصوصی و loopback رد میشوند و هیچ تغییر مسیری دنبال نمیشود.
هر تلاش ثبت میشود
هر کدام نشان میدهد سرور شما چه پاسخی داد و چقدر طول کشید.
روشهای خوب
بیشترین بهره از آن
- 01
اول پاسخ، بعد کار
ظرف پنج ثانیه یک 2xx برگردانید و کارهای کند را بعداً انجام دهید.
- 02
حذف شناسههای تکراری
هر شناسه X-OpenEmail-Delivery را که پردازش میکنید ذخیره کنید و تکراریها را رد کنید.
- 03
تعویض با هر دو کلید
تعویض، کلید را فوراً جایگزین میکند، پس تا وقتی استقرار شما کامل شود، با کلید قدیم و جدید هر دو تأیید کنید.
پرسشها
اغلب میپرسند
ادامه دهید
با اینها خوب کار میکند
شروع
دامنهی خودتان،
ایمیل خودتان.
دامنهای را به OpenEmail متصل کنید و نامههایش را در صندوق پستیای بخوانید که گرد آن ساخته شده است. طرح رایگان یک دامنه را پوشش میدهد.
