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

# البدء السريع

> ابدأ باستخدام واجهات برمجة التطبيقات API من Benzinga ووصل إلى بيانات السوق الآنية والأخبار والمزيد.

<div id="benzinga-apis">
  ## واجهات برمجة التطبيقات API من Benzinga
</div>

بدءًا من تقارير الأرباح وصولًا إلى نشاط الخيارات، تركّز Benzinga على المعلومات التي تحرّك السوق. نقدّم مجموعة من القنوات التي تركز على الأخبار العاجلة، بحيث يمكن لمؤسستك أن تكون الأولى في اقتناص فرص التداول. نوفر طريقتين لتلقي أخبارنا: عبر واجهة برمجة تطبيقات REST معتمدة على السحب (pull-based)، أو عبر TCP معتمد على الدفع (push-based). كلتاهما توفّران وصولًا غير مسبوق إلى الأسواق.

إحدى ركائز Benzinga هي "الانشغال بعملائنا، وليس بمنافسينا."

العلاقات القوية ذات الجودة العالية هي القوة الدافعة وراء نجاح الأعمال، والتزامنا بهذا المبدأ يأتي دائمًا في المقام الأول.

للبدء مع واجهات برمجة التطبيقات API الخاصة بـ Benzinga، يُرجى مراسلتنا مباشرة على [licensing@benzinga.com](mailto:licensing@benzinga.com) أو الاتصال بنا على الرقم: 877-440-9464. سنرد عليك خلال يوم عمل واحد.

<div id="authentication">
  ## المصادقة
</div>

ضمِّن مفتاح واجهة برمجة التطبيقات API أو رمز الوصول الخاص بك كمعامل باسم token في سلسلة استعلام الطلب.

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

نقترح أن يستخدم العملاء البرمجيات العميلة (clients) التي توفّرها Benzinga قدر الإمكان. العديد من نقاط النهاية متاحة في [مكتبة Python](/ar/python-client) الخاصة بنا. نقدّم تطبيقات مرجعية ومكتبات عملاء عبر [GitHub](https://github.com/benzinga) العام الخاص بنا.

أخيرًا، نوصي بشدة باستخدام التحديثات التفاضلية (deltas) عند استخدام واجهات برمجة التطبيقات API الخاصة بـ Calendar وSignals وNews، خصوصًا عند استخدامها للاستيعاب في الزمن الحقيقي (بدلًا من استيعاب البيانات التاريخية). يمكن القيام بذلك باستخدام معامل الاستعلام `parameters[updated]` في واجهات Calendar وSignals، ومعامل الاستعلام `updatedSince` في واجهة News. يضمن استخدام هذه المعاملات أدنى زمن تأخير ممكن (latency).

<div id="max-offset">
  ## الحد الأقصى للإزاحة
</div>

لا يمكن لآلية الترقيم (Pagination) في واجهات News وCalendar وSignals إرجاع مجموعات نتائج تحتوي على أكثر من 10,000 عنصر. أي أنه إذا كان حجم الصفحة 1,000، فلا يمكنك طلب الصفحة رقم 10.

لتجاوز هذا القيد، يجب عليك ضبط نطاق الاستعلام. على سبيل المثال، يمكنك تقييد الاستعلام بنطاق تاريخ محدد أو مجموعة رموز تداول تتضمن أقل من 10,000 عنصر. بعد ذلك يمكنك تعديل الاستعلام ليشمل نطاق تاريخ آخر أو مجموعة أخرى من رموز التداول تتضمن أقل من 10,000 عنصر، ثم دمج المجموعات وتكرار العملية حتى تحصل على مجموعة النتائج الكاملة التي تريدها.

<div id="return-format">
  ## تنسيق الإرجاع
</div>

يتم تحديد التنسيق الافتراضي لواجهات Benzinga لبرمجة التطبيقات في مواصفات كل واجهة على حدة، ولكنه سيكون `JSON` ما لم يُنص على خلاف ذلك.

يمكنك طلب `JSON` عن طريق تعيين الترويسة `accept` إلى `application/json` أو طلب `XML` باستخدام `application/xml` في الحالات التي لا يكون فيها هذا الخيار موقوفًا عن العمل.

**لا يُنصَح بأن تستخدم التكاملات الجديدة تنسيق المخرجات `XML`.**

<div id="example">
  ### مثال
</div>

```JSON theme={null}
curl -X GET \
'http://api.benzinga.com/api/v2/calendar/ratings?token=YOUR_TOKEN_HERE&ratings=Upgrades' \
-H 'accept: application/json'
```