Webhook
إرسال حدث إلى نقطة نهاية HTTPS: إيصالات التسليم والرسائل الواردة وتغييرات الحالة، التي يجب على المستقبِل التحقق منها والإقرار باستلامها سريعًا ووضعها في طابور.
تعريفات فقط — المصطلح المشروح هنا ليس خدمة نبيعها.
الـ Webhook هو استدعاء راجع عبر HTTPS يرسل حدثًا إلى عنوان URL سجّلته، مثل إيصال تسليم أو رسالة واردة. ويتحقق المستقبِل من التوقيع، ويقر بالاستلام برمز 2xx، ويضع العمل في طابور.
يتعامل المستقبِل مع الأحداث المكررة والأحداث التي تصل خارج الترتيب؛ فالـ Webhook تسليم بالدفع.
التحقق ثم الإقرار ثم الطابور
يرسل المزوّد طلب POST عند وقوع حدث، وتعيد نقطة النهاية لديك رمز 2xx للإقرار باستلامه. وتكون الحمولة عادةً بتنسيق JSON وتتضمن نوع الحدث ومعرّفًا. وقد يوقّعها المزوّد؛ تحقق من التوقيع مقابل النص الخام للطلب باستخدام السر المشترك، وارفض الطلبات الواقعة خارج نافذة إعادة الإرسال.
تحقق أولًا، ثم خزّن الحدث الخام، وأعد رمز 2xx، وعالج العمل بشكل غير متزامن. وتتسبب نقاط النهاية البطيئة في إعادة المحاولات. ويكون التسليم عادةً مرة واحدة على الأقل ولا يُحفظ الترتيب، لذا أزل التكرار بالاعتماد على معرّف الحدث. واحتفظ بطابور للرسائل الميتة (dead-letter queue) للأحداث التي تتعذر معالجتها. ويقارن شرح SMPP مقابل HTTP بين الاستدعاءات الراجعة والتسليم القائم على الجلسات.