> ## 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

<div id="overview">
  ## نظرة عامة
</div>

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

<div id="getting-your-api-token">
  ## الحصول على رمز الوصول لواجهة برمجة التطبيقات API
</div>

لاستخدام أدوات Benzinga (Widgets) بكامل إمكاناتها:

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

<div id="using-your-token">
  ## استخدام رمز الوصول الخاص بك
</div>

<div id="basic-authentication">
  ### المصادقة الأساسية
</div>

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

```html theme={null}
<iframe
    frameBorder="0"
    height="600"
    width="100%"
    src="https://widgets.benzinga.com/embed/chart/AAPL?token=YOUR_API_TOKEN&timeframe=6m&exchange=NASDAQ"
></iframe>
```

<div id="best-practices">
  ### أفضل الممارسات
</div>

<Warning>
  **لا تقم أبدًا بكشف رمز الوصول لواجهة برمجة التطبيقات API في شفرة برمجية تعمل على جانب العميل يمكن للمستخدمين الاطلاع عليها.** تم تصميم الويدجتات (widgets) ليتم تضمينها في مواقع الويب العامة، لكن يُنصَح بتنفيذ إدارة رموز الوصول على جانب الخادم قدر الإمكان.
</Warning>

**النهج الموصى به:**

* خزن رموز الوصول كمتغيرات بيئية على خادمك
* أنشئ عناوين URL للويدجتات (widgets) على جانب الخادم مع تضمين رمز الوصول
* استخدم توقيع عناوين URL أو تدوير رموز الوصول لتعزيز الأمان

<div id="token-management">
  ## إدارة رموز الوصول
</div>

<div id="security-considerations">
  ### اعتبارات الأمان
</div>

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

<div id="rate-limits">
  ### حدود المعدل
</div>

رموز وصول واجهة برمجة التطبيقات للويدجت تخضع لحدود معدل وفقًا لاتفاقية الترخيص الخاصة بك:

* المستوى القياسي: حتى 10,000 عملية تحميل للويدجت في اليوم
* المستوى المميز: حتى 100,000 عملية تحميل للويدجت في اليوم
* المستوى المؤسسي: حدود مخصصة وفقًا للاتفاقية

<div id="troubleshooting">
  ## استكشاف الأخطاء وإصلاحها
</div>

<div id="common-authorization-issues">
  ### مشكلات التفويض الشائعة
</div>

**تعرض الأداة رسالة الخطأ "Unauthorized":**

* تحقق من تضمين رمز الوصول بشكل صحيح في الـ URL
* تأكد من أن صلاحية رمز الوصول لم تنتهِ
* تأكد من أنك تصل من نطاق (domain) مصرح به

**البيانات لا يتم تحديثها:**

* تحقق من أن رخصتك تتضمن الوصول إلى البيانات اللحظية (real-time)
* تأكد من أن رمز الوصول يملك الأذونات اللازمة
* تحقق من أنك لم تتجاوز حدود المعدل (rate limits)

<div id="getting-help">
  ### الحصول على المساعدة
</div>

للمشكلات أو الاستفسارات المتعلقة بالتفويض:

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

<div id="next-steps">
  ## الخطوات التالية
</div>

بعد إتمام التفويض، استكشف [خيارات الويدجات](/ar/widgets/overview) المتاحة لتخصيص واجهات عرض بياناتك المالية.