تتطلب ويدجت Benzinga ترخيصًا للوصول إلى الميزات المتقدمة والبيانات في الوقت الفعلي. تتم إدارة الترخيص من خلال رموز الوصول الخاصة بواجهة برمجة التطبيقات API والمضمّنة في عناوين الـ URL الخاصة بالويدجت، مما يضمن وصولًا آمنًا إلى البيانات المالية مع الحفاظ على تكامل سلس.
الحصول على رمز الوصول لواجهة برمجة التطبيقات API
- التواصل مع Benzinga: تواصل مع [email protected] للحصول على رمز الوصول لواجهة برمجة التطبيقات API الخاص بالأدوات (widget API token)
- اتفاقية الترخيص: أكمِل عملية الترخيص للحصول على صلاحية استخدام الأدوات
- استلام بيانات الاعتماد: ستتلقى رمز الوصول الفريد لواجهة برمجة التطبيقات API الخاص بك لتفويض استخدام الأدوات
استخدام رمز الوصول الخاص بك
token:
<iframe
frameBorder="0"
height="600"
width="100%"
src="https://widgets.benzinga.com/embed/chart/AAPL?token=YOUR_API_TOKEN&timeframe=6m&exchange=NASDAQ"
></iframe>
لا تقم أبدًا بكشف رمز الوصول لواجهة برمجة التطبيقات API في شفرة برمجية تعمل على جانب العميل يمكن للمستخدمين الاطلاع عليها. تم تصميم الويدجتات (widgets) ليتم تضمينها في مواقع الويب العامة، لكن يُنصَح بتنفيذ إدارة رموز الوصول على جانب الخادم قدر الإمكان.
- خزن رموز الوصول كمتغيرات بيئية على خادمك
- أنشئ عناوين URL للويدجتات (widgets) على جانب الخادم مع تضمين رمز الوصول
- استخدم توقيع عناوين URL أو تدوير رموز الوصول لتعزيز الأمان
- حافظ على رموز الوصول سرّية: لا تقم بتضمين رموز الوصول في نظام التحكم في الإصدارات
- راقب الاستخدام: تتبّع تحميلات الودجت لاكتشاف أي استخدام غير مصرّح به
- جدّد رموز الوصول دوريًا: اطلب رموز وصول جديدة بشكل دوري من Benzinga
- قيود النطاق (الدومين): أعدد النطاقات المسموح بها بالتنسيق مع دعم Benzinga
رموز وصول واجهة برمجة التطبيقات للويدجت تخضع لحدود معدل وفقًا لاتفاقية الترخيص الخاصة بك:
- المستوى القياسي: حتى 10,000 عملية تحميل للويدجت في اليوم
- المستوى المميز: حتى 100,000 عملية تحميل للويدجت في اليوم
- المستوى المؤسسي: حدود مخصصة وفقًا للاتفاقية
تعرض الأداة رسالة الخطأ “Unauthorized”:
- تحقق من تضمين رمز الوصول بشكل صحيح في الـ URL
- تأكد من أن صلاحية رمز الوصول لم تنتهِ
- تأكد من أنك تصل من نطاق (domain) مصرح به
البيانات لا يتم تحديثها:
- تحقق من أن رخصتك تتضمن الوصول إلى البيانات اللحظية (real-time)
- تأكد من أن رمز الوصول يملك الأذونات اللازمة
- تحقق من أنك لم تتجاوز حدود المعدل (rate limits)
للمشكلات أو الاستفسارات المتعلقة بالتفويض:
- البريد الإلكتروني: [email protected]
- ضمّن بنية widget URL الخاصة بك (مع إخفاء رمز الوصول)
- اشرح الخطأ المحدد أو السلوك الذي تواجهه
بعد إتمام التفويض، استكشف خيارات الويدجات المتاحة لتخصيص واجهات عرض بياناتك المالية. 
