استقبل التحديثات عبر خطافات الويب

الغرض منها

خطاف الويب (Webhook) رسالة ترسلها شوق إلى خادمك عند وقوع حدث ما، فلا يحتاج نظامك إلى السؤال باستمرار. يمكن أن تُفيد بأن:

• موظفًا أُضيف أو عُدّلت بياناته أو أُوقف؛
• شخصًا سُجّل في دورة أو أتمّها أو رسب فيها، أو أُلغي تسجيله، أو مُنح محاولة أخرى؛
• شهادة صدرت.

تذكر الرسالة ما حدث وتحمل معرّفات لا بيانات شخصية، ثم يقرأ نظامك السجل الذي يحتاجه عبر واجهة البرمجة.

أضف وجهة

1. افتح الشركة، ثم التكاملات ثم Webhooks.
2. اختر إضافة وجهة، وأعطها اسمًا وعنوان HTTPS لخادمك. لا يمكن تغيير العنوان لاحقًا؛ أضف وجهة جديدة إن انتقل خادمك.
3. حدّد الأحداث التي يحتاجها ذلك الخادم.
4. انسخ سر التوقيع عند ظهوره، فهو يظهر مرة واحدة.
5. أعدّ التحقق من التوقيع على خادمك، واستخدم إرسال عيّنة، ثم فعّل الوجهة.

تحقّق من كل رسالة

تحمل كل رسالة ثلاثة ترويسات: webhook-id وwebhook-timestamp وwebhook-signature. على خادمك أن يوقّع جسم الرسالة الخام بسر الوجهة ويقارن، وأن يرفض رسالة مضى على طابعها الزمني أكثر من خمس دقائق، وأن يتجاهل معرّفًا عالجه من قبل. ويعرض تبويب الأحداث والتوقيع مستقبِلًا جاهزًا للنسخ.

إذا توقف خادمك

ردّ بأي رمز 2xx سريعًا ثم أنجز العمل. الرسالة التي لا يأتيها رد، أو يأتيها رد غير 2xx، يُعاد إرسالها بفواصل متزايدة لمدة تصل إلى 72 ساعة. ويعرض تبويب عمليات التسليم آخر 30 يومًا، وكل محاولة وحمولتها، ويتيح إعادة الإرسال.