الويب هوك هو طلب HTTP ترسله خدمة إلى عنوان URL تقوم بتسجيله كلما حدث حدث معين. يتيح لنظامك تلقي البيانات أثناء حدوثها، بدلاً من استعلام API عن طريق استدعائه مرارًا وتكرارًا لمعرفة ما إذا كان هناك أي شيء جديد متاح. في خط أنابيب البيانات، يعني ذلك أن الوظيفة يمكن أن تتفاعل مع حدث بمجرد أن يبلغ المصدر عنه.

على سبيل المثال، ترسل منصة الدفع Stripe أحداث الويب هوك إلى نقطة النهاية الخاصة بك عبر HTTPS كحمولة JSON. يجب أن تقبل نقطة النهاية الخاصة بك طلبات POST وتعالج بيانات الحدث التي تتلقاها.

كيفية عمل تسليم الويب هوك

تظهر وثائق Stripe الآليات الرئيسية:

  • التسجيل: تقوم بتسجيل عنوان URL لنقطة النهاية. في وضع التشغيل المباشر، تتطلب Stripe عنوان URL HTTPS يمكن الوصول إليه علنًا.
  • الاعتراف السريع: يجب أن تعيد نقطة النهاية رمز حالة 2xx بسرعة، قبل أي منطق معقد قد يتسبب في انتهاء المهلة.
  • إعادة المحاولة: إذا فشل التسليم، تعيد Stripe المحاولة لمدة تصل إلى ثلاثة أيام مع تراجع أسي في وضع التشغيل المباشر.
  • الترتيب: لا تضمن Stripe أن تصل الأحداث بالترتيب الذي تم إنشاؤها به.

تأمين نقطة نهاية الويب هوك

  • تحقق من التوقيعات: تقوم Stripe بتوقيع كل حدث باستخدام HMAC باستخدام SHA-256 وتضع التوقيع في رأس Stripe-Signature.
  • حظر الإعادة: تتضمن الحمولة الموقعة طابع زمني، لذا يمكنك رفض الأحداث التي تكون قديمة جدًا.
  • التعامل مع التكرارات: يمكن أن تتلقى نقطة النهاية نفس الحدث أكثر من مرة. قم بتسجيل معرفات الأحداث المعالجة وتجاوز التكرارات.
  • قائمة المرسلين المسموح لهم: ترسل Stripe الويب هوكات من قائمة منشورة من عناوين IP التي يمكنك تقييد جدار الحماية الخاص بك بها.

الاستخدامات الشائعة للويب هوك

  • الكود والنشر: ترسل GitHub حمولة HTTP POST إلى عنوان URL الخاص بك لأحداث المستودع التي اشتركت فيها. تسرد وثائقها استخدامات مثل بدء بناء CI، تحديث متتبع القضايا الخارجي، تحديث مرآة احتياطية ونشرها على خادم الإنتاج.
  • المدفوعات: تتيح لك ويب هوكات Stripe الاستجابة للأحداث غير المتزامنة، مثل تأكيد البنك لعملية دفع، أو عميل يتنازع على رسوم، أو نجاح عملية دفع متكررة.
  • اشترك فقط فيما تحتاجه: تنصح Stripe بعدم الاستماع إلى أحداث إضافية أو جميع الأحداث لأنها تضع ضغطًا غير ضروري على خادمك.

المصطلحات ذات الصلة