> ## 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.
# نظرة عامة
> دليل عالي المستوى لتدفقات بيانات ويب سوكيت الفورية من Benzinga.
توفّر واجهة برمجة التطبيقات API الخاصة بـ Benzinga عبر ويب سوكيت بيانات مالية منخفضة الكمون وقائمة على الدفع مباشرة إلى تطبيقك. بدلًا من الاستعلام المتكرر عن نقطة نهاية REST، تقوم بفتح اتصال واحد مستمر وتتلقى الأحداث فور توفّرها — تقييمات المحلّلين، نتائج الأرباح، الأخبار، نصوص المكالمات، والمزيد.
تستخدم جميع التدفقات نفس نقطة النهاية الأساسية، ونموذج المصادقة، وغلاف الرسائل، لذا فإن الأنماط التي تتعلّمها في تدفّق واحد تنطبق في كل مكان.
## كيف يعمل
احصل على رمز وصول واجهة برمجة التطبيقات API من [Benzinga Console](https://www.api.benzinga.com/token) وألحِقه كمعامل استعلام `token` عند فتح الاتصال.
افتح اتصال ويب سوكيت إلى عنوان تدفق البيانات الذي تحتاجه — على سبيل المثال `wss://api.benzinga.com/api/v1/analyst/insights/stream?token=YOUR_TOKEN`.
تصل الرسائل ككائنات JSON ذات غلاف ثابت البنية: يحتوي على `id` و `api_version` و `kind` وكتلة `data` التي تحمل الحقل `action` (`created` أو `updated` أو `deleted`) وبيانات الحمولة.
أرسل إطار نصي عادي `ping` بشكل دوري (كل 30–60 ثانية). يستجيب الخادم بـ `pong`. يرسل الخادم أيضًا طلبات ping خاصة به كل 10 ثوانٍ — تتولى معظم مكتبات ويب سوكيت التعامل مع ذلك تلقائيًا.
## التدفقات المتاحة
تصنيفات المحللين في الوقت الفعلي، والأسعار المستهدفة، والتوصيات التفصيلية عند نشرها.
تغييرات تصنيفات المحللين وتحديثات الأسعار المستهدفة من الشركات الكبرى.
التصنيفات التوافقية المجمَّعة والأسعار المستهدفة عبر جميع المحللين الذين تتم متابعتهم.
إعلانات الأرباح مع بيانات ربحية السهم (EPS)، والإيرادات، والتقديرات، ومؤشرات المفاجأة.
سيناريوهات الحالة المتفائلة والحالة المتشائمة للأوراق المالية، تُنشَر في الوقت الفعلي.
مقالات الأخبار العاجلة وتحديثات السوق من فريق التحرير في Benzinga.
نصوص حية لمكالمات الأرباح تُنقَل جملةً بجملة أثناء النطق بها.
## غلاف الرسالة
كل رسالة في الدفق تتبع نفس البنية على المستوى الأعلى:
```json theme={null}
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"api_version": "websocket/v1",
"kind": "",
"data": {
"action": "created",
"id": "",
"timestamp": "2024-10-08T10:00:00Z",
"content": { ... }
}
}
```
| الحقل | الوصف |
| -------------- | ----------------------------------------------------------------- |
| `id` | المعرّف الفريد للرسالة — استخدمه لإلغاء التكرار عند إعادة الاتصال |
| `api_version` | إصدار بروتوكول الرسالة |
| `kind` | يحدد أي تدفق جاءت منه الرسالة |
| `data.action` | إحدى القيم `created` أو `updated` أو `deleted` |
| `data.content` | حمولة خاصة بالتدفق |
## صفحات مرجعية
كيفية الحصول على رمز الوصول لواجهة برمجة التطبيقات API الخاصة بك واستخدامه.
أوامر `ping` و`replay` التي يمكنك إرسالها على أي تدفق.
رموز الأخطاء وكيفية معالجة حالات فشل الاتصال.