الانتقال إلى المحتوى الرئيسي
خدمات الويب هوك (Webhooks) هي طريقة OTO في إبلاغ أنظمتك بأن شيئًا ما قد حدث، بدلًا من أن تسأل أنظمتك مرارًا عما إذا كان قد حدث شيء.

الأحداث الثلاثة

الإعداد

سجِّل رابطًا (URL) من الإعدادات ← Developers ‏← Webhooks، أو عبر POST /rest/v2/webhook. تختار الطريقة، ونوع الحدث، ومفتاح تفويض، ومفتاحًا سريًا؛ وتُوقَّع كل حمولة بيانات بـ HMAC-SHA256 ليتمكن الخادم لديك من إثبات أنها واردة من OTO. تجد الحمولات كاملةً، وآلية التوقيع، وقواعد بناء نقطة نهاية تتحمل الإرسال المكرر والوصول بغير ترتيب، في أحداث الويب هوك.
تحقَّق من التوقيع، فالرابط ليس سرًّاأي شخص يعرف رابط الويب هوك الخاص بك يمكنه الإرسال إليه. ودون التحقق، يستطيع أن يُبلغ نظامك بأن طلبًا قد تم توصيله.أعد حساب الـ HMAC، وقارِن في زمن ثابت، وارفض الطوابع الزمنية القديمة.

البديل، ولماذا لا يصلح مع النموّ

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

صفحات ذات صلة