نظرة عامة

دليل عالي المستوى لتدفقات بيانات ويب سوكيت الفورية من Benzinga.

توفّر واجهة برمجة التطبيقات API الخاصة بـ Benzinga عبر ويب سوكيت بيانات مالية منخفضة الكمون وقائمة على الدفع مباشرة إلى تطبيقك. بدلًا من الاستعلام المتكرر عن نقطة نهاية REST، تقوم بفتح اتصال واحد مستمر وتتلقى الأحداث فور توفّرها — تقييمات المحلّلين، نتائج الأرباح، الأخبار، نصوص المكالمات، والمزيد.

تستخدم جميع التدفقات نفس نقطة النهاية الأساسية، ونموذج المصادقة، وغلاف الرسائل، لذا فإن الأنماط التي تتعلّمها في تدفّق واحد تنطبق في كل مكان.

​

كيف يعمل

1. المصادقة

   احصل على رمز وصول واجهة برمجة التطبيقات API من Benzinga Console وألحِقه كمعامل استعلام token عند فتح الاتصال.

2. الاتصال

   افتح اتصال ويب سوكيت إلى عنوان تدفق البيانات الذي تحتاجه — على سبيل المثال wss://api.benzinga.com/api/v1/analyst/insights/stream?token=YOUR_TOKEN.

3. استقبال الأحداث

   تصل الرسائل ككائنات JSON ذات غلاف ثابت البنية: يحتوي على id و api_version و kind وكتلة data التي تحمل الحقل action (created أو updated أو deleted) وبيانات الحمولة.

4. الحفاظ على الاتصال فعالًا

   أرسل إطار نصي عادي ping بشكل دوري (كل 30–60 ثانية). يستجيب الخادم بـ pong. يرسل الخادم أيضًا طلبات ping خاصة به كل 10 ثوانٍ — تتولى معظم مكتبات ويب سوكيت التعامل مع ذلك تلقائيًا.

​

التدفقات المتاحة

رؤى المحللين

تصنيفات المحللين في الوقت الفعلي، والأسعار المستهدفة، والتوصيات التفصيلية عند نشرها.

التصنيفات

تغييرات تصنيفات المحللين وتحديثات الأسعار المستهدفة من الشركات الكبرى.

تصنيفات الإجماع

التصنيفات التوافقية المجمَّعة والأسعار المستهدفة عبر جميع المحللين الذين تتم متابعتهم.

الأرباح

إعلانات الأرباح مع بيانات ربحية السهم (EPS)، والإيرادات، والتقديرات، ومؤشرات المفاجأة.

ما يقوله المتفائلون/المتشائمون

سيناريوهات الحالة المتفائلة والحالة المتشائمة للأوراق المالية، تُنشَر في الوقت الفعلي.

الأخبار

مقالات الأخبار العاجلة وتحديثات السوق من فريق التحرير في Benzinga.

نصوص مكالمات الأرباح

نصوص حية لمكالمات الأرباح تُنقَل جملةً بجملة أثناء النطق بها.

​

غلاف الرسالة

كل رسالة في الدفق تتبع نفس البنية على المستوى الأعلى:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "api_version": "websocket/v1",
  "kind": "<stream-type>",
  "data": {
    "action": "created",
    "id": "<record-id>",
    "timestamp": "2024-10-08T10:00:00Z",
    "content": { ... }
  }
}

الحقل	الوصف
id	المعرّف الفريد للرسالة — استخدمه لإلغاء التكرار عند إعادة الاتصال
api_version	إصدار بروتوكول الرسالة
kind	يحدد أي تدفق جاءت منه الرسالة
data.action	إحدى القيم created أو updated أو deleted
data.content	حمولة خاصة بالتدفق

​

صفحات مرجعية

المصادقة

كيفية الحصول على رمز الوصول لواجهة برمجة التطبيقات API الخاصة بك واستخدامه.

الإجراءات المدعومة

أوامر ping وreplay التي يمكنك إرسالها على أي تدفق.

الأخطاء

رموز الأخطاء وكيفية معالجة حالات فشل الاتصال.