Skip to main content

​
نظرة عامة

تتطلب ويدجت Benzinga ترخيصًا للوصول إلى الميزات المتقدمة والبيانات في الوقت الفعلي. تتم إدارة الترخيص من خلال رموز الوصول الخاصة بواجهة برمجة التطبيقات API والمضمّنة في عناوين الـ URL الخاصة بالويدجت، مما يضمن وصولًا آمنًا إلى البيانات المالية مع الحفاظ على تكامل سلس.

​
الحصول على رمز الوصول لواجهة برمجة التطبيقات API

لاستخدام أدوات Benzinga (Widgets) بكامل إمكاناتها:
  1. التواصل مع Benzinga: تواصل مع licensing@benzinga.com للحصول على رمز الوصول لواجهة برمجة التطبيقات API الخاص بالأدوات (widget API token)
  2. اتفاقية الترخيص: أكمِل عملية الترخيص للحصول على صلاحية استخدام الأدوات
  3. استلام بيانات الاعتماد: ستتلقى رمز الوصول الفريد لواجهة برمجة التطبيقات API الخاص بك لتفويض استخدام الأدوات

​
استخدام رمز الوصول الخاص بك

​
المصادقة الأساسية

أضف رمز الوصول لواجهة برمجة التطبيقات API إلى عنوان URL للويدجت باستخدام المعامل token:

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

لا تقم أبدًا بكشف رمز الوصول لواجهة برمجة التطبيقات API في شفرة برمجية تعمل على جانب العميل يمكن للمستخدمين الاطلاع عليها. تم تصميم الويدجتات (widgets) ليتم تضمينها في مواقع الويب العامة، لكن يُنصَح بتنفيذ إدارة رموز الوصول على جانب الخادم قدر الإمكان.
النهج الموصى به:
  • خزن رموز الوصول كمتغيرات بيئية على خادمك
  • أنشئ عناوين URL للويدجتات (widgets) على جانب الخادم مع تضمين رمز الوصول
  • استخدم توقيع عناوين URL أو تدوير رموز الوصول لتعزيز الأمان

​
إدارة رموز الوصول

​
اعتبارات الأمان

  • حافظ على رموز الوصول سرّية: لا تقم بتضمين رموز الوصول في نظام التحكم في الإصدارات
  • راقب الاستخدام: تتبّع تحميلات الودجت لاكتشاف أي استخدام غير مصرّح به
  • جدّد رموز الوصول دوريًا: اطلب رموز وصول جديدة بشكل دوري من Benzinga
  • قيود النطاق (الدومين): أعدد النطاقات المسموح بها بالتنسيق مع دعم Benzinga

​
حدود المعدل

رموز وصول واجهة برمجة التطبيقات للويدجت تخضع لحدود معدل وفقًا لاتفاقية الترخيص الخاصة بك:
  • المستوى القياسي: حتى 10,000 عملية تحميل للويدجت في اليوم
  • المستوى المميز: حتى 100,000 عملية تحميل للويدجت في اليوم
  • المستوى المؤسسي: حدود مخصصة وفقًا للاتفاقية

​
استكشاف الأخطاء وإصلاحها

​
مشكلات التفويض الشائعة

تعرض الأداة رسالة الخطأ “Unauthorized”:
  • تحقق من تضمين رمز الوصول بشكل صحيح في الـ URL
  • تأكد من أن صلاحية رمز الوصول لم تنتهِ
  • تأكد من أنك تصل من نطاق (domain) مصرح به
البيانات لا يتم تحديثها:
  • تحقق من أن رخصتك تتضمن الوصول إلى البيانات اللحظية (real-time)
  • تأكد من أن رمز الوصول يملك الأذونات اللازمة
  • تحقق من أنك لم تتجاوز حدود المعدل (rate limits)

​
الحصول على المساعدة

للمشكلات أو الاستفسارات المتعلقة بالتفويض:
  • البريد الإلكتروني: licensing@benzinga.com
  • ضمّن بنية widget URL الخاصة بك (مع إخفاء رمز الوصول)
  • اشرح الخطأ المحدد أو السلوك الذي تواجهه

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

بعد إتمام التفويض، استكشف خيارات الويدجات المتاحة لتخصيص واجهات عرض بياناتك المالية.