الاتصال بخادم TCP

يوضح هذا الدليل كيفية الاتصال بخادم بث TCP من Benzinga والبدء في تلقي البيانات في الوقت الفعلي.

​

نقطة نهاية الخادم

المعامل	القيمة
Host	tcp-v1.benzinga.io
Port	11337
Protocol	TCP
TLS	اختياري (معطَّل بشكل افتراضي)

​

المصادقة

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

bztcp -v -user YOUR_USERNAME -key YOUR_API_KEY

​

خيارات سطر الأوامر

الخيار	الوصف
-user	اسم مستخدم TCP الخاص بك لدى Benzinga
-key	مفتاح الوصول الخاص بك إلى واجهة برمجة التطبيقات API
-v	تفعيل المخرجات التفصيلية

​

تسلسل الاتصال

​

حالات الاتصال

بمجرد الاتصال، ستظهر لك رسائل التهيئة الأولية:

Benzinga TCP Client initializing.
Connecting to 'tcp-v1.benzinga.io:11337' as user 'YOUR_USERNAME' (w/TLS: false)
Connected. Waiting for events.

بعد إنشاء الاتصال، يبدأ تدفّق رسائل JSON تلقائيًا.

​

تهيئة TLS

افتراضيًا، تُجرى الاتصالات بدون TLS. لتمكين تشفير TLS، استخدم العلم (flag) المناسب الذي توفره مكتبة العميل الخاصة بك.

​

أفضل ممارسات الاتصال

حافظ على اتصالك نشطًا لتلقي التحديثات المستمرة. نفّذ آلية لإعادة الاتصال للتعامل مع انقطاعات الشبكة بسلاسة.

​

الممارسات الموصى بها

1. تنفيذ منطق إعادة الاتصال: قد تحدث انقطاعات في الشبكة؛ نفّذ آلية تراجع أسي (exponential backoff) لمحاولات إعادة الاتصال
2. التعامل مع حالات انقطاع الاتصال: راقب حالة الاتصال وأعد الاتصال عند الحاجة
3. تخزين الرسائل مؤقتًا: عالج الرسائل بشكل غير متزامن لتجنّب حظر حلقة الاستقبال
4. تسجيل أحداث الاتصال: تتبّع حالة الاتصال لأغراض التصحيح والمراقبة

​

مثال اتصال

Go

conn, err := bztcp.Dial("tcp-v1.benzinga.io:11337", "USERNAME", "API_KEY")
if err != nil {
    log.Fatal(err)
}

Python

from bztcp.client import Client

client = Client(username='USERNAME', key='API_KEY')

​

الخطوات التالية

• Message Format - تعرّف على بنية الرسائل
• Python Client - التوثيق الكامل لمكتبة Python
• Go Client - التوثيق الكامل لمكتبة Go