الانتقال إلى المحتوى الرئيسي

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

المعاملالقيمة
Hosttcp-v1.benzinga.io
Port11337
ProtocolTCP
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. تسجيل أحداث الاتصال: تتبّع حالة الاتصال لأغراض التصحيح والمراقبة

مثال اتصال

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

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

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