> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على Webhook

> ادفع بيانات السوق من Benzinga إلى أنظمتك عبر webhooks قوية وقابلة للتصفية.

تلغي webhooks من Benzinga الحاجة إلى الاستعلام الدوري (polling) من خلال إرسال أحداث السوق اللحظية مباشرةً إلى نقطة نهاية HTTP الخاصة بك. تكون عمليات التسليم طلبات `POST` بتنسيق JSON تتضمن رأسًا فريدًا `X-BZ-Delivery` لمنع التكرار، وتستخدم إستراتيجية إعادة محاولة متدرجة المستويات لتعظيم الاعتمادية.

<div id="available-webhook-services">
  ## خدمات Webhook المتاحة
</div>

* **Data Webhook Engine**: بيانات التقويم المالي والإشارات اللحظية (الأرباح، توزيعات الأرباح، التقييمات، نشاط الخيارات، WIIMs، وغير ذلك) مع فلاتر قابلة للتهيئة وتحويلات اختيارية للحمولة. اقرأ الدليل الكامل في [Data Webhook Engine](./webhook-engine).
* يمكن تخصيص تهيئات Webhook إضافية لحسابك. تواصل مع ممثل Benzinga لديك لتمكين مجموعات بيانات محددة أو لتسجيل عناوين URL جديدة للـ Webhook.

<div id="integration-flow">
  ## تدفق التكامل
</div>

<Steps>
  <Step title="مشاركة نقطة النهاية والفلاتر الخاصة بك">
    قدّم نقطة نهاية HTTPS يمكن الوصول إليها بشكل عام، بالإضافة إلى أي فلاتر لنوع البيانات أو النطاق الجغرافي الذي تحتاجه. ستقوم Benzinga بإعداد الـ webhook بهذه الإعدادات.
  </Step>

  <Step title="اختبار التكامل الخاص بك">
    استخدم نقطة نهاية [Test Webhook Delivery](/ar/api-reference/webhook_api/test-webhook-delivery) للتحقق من أن نقطة نهاية الـ webhook لديك مهيأة بشكل صحيح ويمكنها استلام عمليات التسليم.
  </Step>

  <Step title="التعامل مع عمليات التسليم بطريقة عديمة الأثر (Idempotent)">
    حلّل حمولة JSON، واستخدم قيم `id` و `X-BZ-Delivery` لتجنب التكرارات، واستجب بسرعة بحالة 2xx لتأكيد الاستلام.
  </Step>

  <Step title="المراقبة والتحسين المستمر">
    تتبّع حالات الفشل، وانتهاء المهلة (timeouts)، وإعادة المحاولة في سجلاتك. عدّل الفلاتر أو تحويلات الحمولة بالتعاون مع جهة الاتصال الخاصة بك في Benzinga إذا ظهرت متطلبات جديدة في الأنظمة اللاحقة لديك.
  </Step>
</Steps>

<div id="best-practices">
  ## أفضل الممارسات
</div>

* استخدم HTTPS والمصادقة على نقطة نهاية webhook الخاصة بك.
* عالج العمل بشكل غير متزامن بحيث تُعاد الاستجابات خلال 30 ثانية.
* خزِّن معرِّفات التسليم التي تمّت معالجتها لضمان عدم التكرار عبر محاولات إعادة الإرسال.
* اختبر على نقاط نهاية غير إنتاجية قبل الانتقال إلى التسليم في بيئة الإنتاج.