POST بتنسيق JSON تتضمن رأسًا فريدًا X-BZ-Delivery لمنع التكرار، وتستخدم إستراتيجية إعادة محاولة متدرجة المستويات لتعظيم الاعتمادية.
خدمات Webhook المتاحة
- Data Webhook Engine: بيانات التقويم المالي والإشارات اللحظية (الأرباح، توزيعات الأرباح، التقييمات، نشاط الخيارات، WIIMs، وغير ذلك) مع فلاتر قابلة للتهيئة وتحويلات اختيارية للحمولة. اقرأ الدليل الكامل في Data Webhook Engine.
- يمكن تخصيص تهيئات Webhook إضافية لحسابك. تواصل مع ممثل Benzinga لديك لتمكين مجموعات بيانات محددة أو لتسجيل عناوين URL جديدة للـ Webhook.
تدفق التكامل
1
مشاركة نقطة النهاية والفلاتر الخاصة بك
قدّم نقطة نهاية HTTPS يمكن الوصول إليها بشكل عام، بالإضافة إلى أي فلاتر لنوع البيانات أو النطاق الجغرافي الذي تحتاجه. ستقوم Benzinga بإعداد الـ webhook بهذه الإعدادات.
2
اختبار التكامل الخاص بك
استخدم نقطة نهاية Test Webhook Delivery للتحقق من أن نقطة نهاية الـ webhook لديك مهيأة بشكل صحيح ويمكنها استلام عمليات التسليم.
3
التعامل مع عمليات التسليم بطريقة عديمة الأثر (Idempotent)
حلّل حمولة JSON، واستخدم قيم
id و X-BZ-Delivery لتجنب التكرارات، واستجب بسرعة بحالة 2xx لتأكيد الاستلام.4
المراقبة والتحسين المستمر
تتبّع حالات الفشل، وانتهاء المهلة (timeouts)، وإعادة المحاولة في سجلاتك. عدّل الفلاتر أو تحويلات الحمولة بالتعاون مع جهة الاتصال الخاصة بك في Benzinga إذا ظهرت متطلبات جديدة في الأنظمة اللاحقة لديك.
أفضل الممارسات
- استخدم HTTPS والمصادقة على نقطة نهاية webhook الخاصة بك.
- عالج العمل بشكل غير متزامن بحيث تُعاد الاستجابات خلال 30 ثانية.
- خزِّن معرِّفات التسليم التي تمّت معالجتها لضمان عدم التكرار عبر محاولات إعادة الإرسال.
- اختبر على نقاط نهاية غير إنتاجية قبل الانتقال إلى التسليم في بيئة الإنتاج.