Webhooks
استدعاءات HTTP إلى خادمك عند تغيّر حالة عملية تسليم: لا استعلام متكرر، بيانات في الوقت الفعلي.
النقاط الرئيسية
- تحقق دائماً من توقيع HMAC للطلبات الواردة: فهو يضمن أن الحمولة قادمة فعلاً من NotifyHub.
- أجب بـ 2xx بسرعة وعالج الحمولة بشكل غير متزامن: الردود البطيئة يُعاد إرسالها.
- استخدم سجل تسليمات webhook لتصحيح الأخطاء: يعرض الحمولة ورد خادمك والمحاولات المعادة.
ما الغرض من هذه الصفحة
تُخطر Webhooks نظامك عند وقوع حدث في NotifyHub، وعادةً تغيّرات حالة عمليات التسليم (مُسلَّمة، فاشلة...). تسجّل عنوان خادمك والأحداث التي تهمك: وعند كل حدث يرسل NotifyHub طلب HTTP موقّعاً مع الحمولة الكاملة.
كيفية الاستخدام
يسرد الجدول نقاط النهاية مع العنوان والأحداث المشترَك فيها والحالة وآخر تشغيل. يمكنك تفعيل نقطة نهاية أو تعطيلها بالمفتاح (مفيد أثناء صيانة خادمك) أو حذفها. والطلبات موقّعة بـ HMAC: ويُسلَّم إليك سر التحقق عند إنشاء نقطة النهاية.
التسليمات والمحاولات المعادة
كل استدعاء لنقطة نهايتك يُتعقَّب في صفحة تسليمات webhook، مع الحمولة المُرسلة ورمز الرد وعدد المحاولات: في حال خطأ من خادمك يعيد NotifyHub المحاولة تلقائياً، ويمكنك أيضاً إعادة إطلاق تسليم فاشل يدوياً. وإذا بقيت نقطة نهايتك متوقفة طويلاً، فراجع السجل لاستعادة الأحداث المفقودة.