المنتج

Webhooks موقعة

أحداث تسليم بتوقيع HMAC.

ابدأالتوثيق
HMAC-SHA256
// Headers: Postline-Timestamp, Postline-Event-Id, Postline-Signature
signed   = timestamp + "\0" + event_id + "\0" + raw_body
expected = "v1=" + hex(HMAC-SHA256(webhook_secret, signed))
constant_time_compare(expected, Postline-Signature)

// 2xx acknowledges the event. Otherwise up to 6 attempts:
// now, +1m, +5m, +30m, +2h, +8h (15 s timeout each)

الأحداث

اشترك لكل نقطة في 1 إلى 20 من أنواع الأحداث التالية:

  • email.accepted
  • email.queued
  • email.sent
  • email.delivered
  • email.deferred
  • email.bounced
  • email.complained
  • email.opened
  • email.clicked
  • email.received
  • email.suppressed
  • domain.verified
  • domain.failed

متطلبات المستقبِل

  • احسب التوقيع من نص الطلب الخام (raw) الدقيق.
  • قارن التوقيعات بزمن ثابت (constant time).
  • ارفض الطوابع الزمنية خارج النافذة المسموح بها.
  • احفظ event_id وعالج كل حدث مرة واحدة فقط.
  • لا تفترض وصول الأحداث بترتيب دورة الحياة.

ضوابط الاتصال الصادر

يتطلب إنشاء نقطة النهاية استخدام HTTPS. تُحظر الوجهات الخاصة وloopback وlink-local وmetadata والوجهات الحاملة لبيانات اعتماد أو الداخلية، ويُعاد تحليلها (resolve) وقت الاتصال أيضًا. لا يتم اتباع عمليات إعادة التوجيه (redirects). يستخدم التسليم مهلات محدودة وعددًا محدودًا من محاولات إعادة المحاولة.

المهلات وإعادة المحاولة

أي استجابة 2xx تؤكد الحدث. انتهاء المهلة (15 ثانية) أو خطأ الشبكة أو أي حالة أخرى تُعد فشلًا. يجري Postline حتى 6 محاولات: الأولى ثم بعد 1 د و5 د و30 د وساعتين و8 ساعات. تُسجَّل كل محاولة في سجل التسليم ويمكن إعادة أي تسليم يدويًا عبر API أو لوحة التحكم.

الموارد

تحقّق من كل حدث تسليمواجهة REST API للبريد الإلكتروني المعاملاتيالأمان في Postline