توفر واجهة برمجة التطبيقات (API) لـ EXANTE عبر بروتوكول HTTP واجهة تعمل وفقًا لمعايير REST للوصول إلى معلومات الحساب وإدارة الأوامر واسترداد بيانات السوق. وهي تستخدم طرق HTTP القياسية، مثل GET وPOST، ولغة JSON لتبادل البيانات.
روابط تتعلق بتكامل واجهة برمجة التطبيقات (API) ومواصفاتها:
تكامل واجهة برمجة التطبيقات (API) عبر بروتوكول HTTP: https://api.exante.eu/http-api/ - يقدم إرشادات حول إعداد اتصال عبر بروتوكول HTTP لبث الأسعار المباشرة وتطوير التطبيقات المالية
مواصفات واجهة برمجة التطبيقات (API) عبر بروتوكول HTTP: https://api-live.exante.eu/api-docs/ - تصف القواعد والإرشادات الخاصة بالتفاعل مع واجهة برمجة التطبيقات (API) من خلال طلبات HTTP.
كيف يمكنني إنشاء مفاتيح لواجهة برمجة التطبيقات (API) الخاصة بـ HTTP؟
يمكنك إنشاء مفاتيح لكل من بيئتي «Live» و«Demo» في «منطقة العميل» الخاصة بك ضمن «الإعدادات» → «إدارة واجهة برمجة التطبيقات». لإضافة مفتاح جديد، انقر على زر «إضافة مفتاح واجهة برمجة التطبيقات».
الإعدادات → إدارة واجهة برمجة التطبيقات
ما هي الأذونات الرئيسية التي يتضمنها مفتاح واجهة برمجة التطبيقات (API) لـ HTTP؟
يمكن أن تتضمن كل مفتاح جميع الأذونات التالية أو مجموعة مختارة منها فقط:
الرموز - يتيح لك هذا الإذن تقديم الطلبات التالية:
الحصول على البورصات - عرض قائمة البورصات
الحصول على الأدوات المالية عن طريق المقايضة - إعادة الأدوات المالية المطلوبة للمقايضة
ملاحظة: نوصي بتجنب تقديم الطلبات المتعلقة بـ CBOE، حيث من المرجح أن تفشل هذه الطلبات بسبب العدد الكبير من الأدوات المالية المعنية.
الحصول على مجموعات الآلات - إرجاع قائمة بمجموعات الآلات المتاحة
الحصول على الأدوات المالية حسب المجموعة - إرجاع الأدوات المالية التي تنتمي إلى مجموعة محددة
الحصول على قائمة الأدوات - إرجاع قائمة بالأدوات المتاحة للمستخدم المصرح له
الحصول على قائمة مفصلة بالعملات المتاحة - عرض القائمة المفصلة بالعملات المتاحة
الحصول على الأداة - إرجاع الأداة المتاحة للمستخدم المصرح له
الحصول على الجدول الزمني للأداة المالية - إرجاع الجدول المالي الخاص بالأداة المطلوبة
الحصول على مواصفات الجهاز - الحصول على مواصفات الجهاز
الحصول على أنواع الأدوات - إرجاع قائمة بأنواع الأدوات المعروفة
الحصول على الأدوات المالية حسب النوع - عرض الأدوات المالية من النوع المطلوب
موجز الأخبار - يتيح لك هذا الإذن إرسال الطلبات التالية:
الحصول على دفق الصفقات - إرجاع دفق الصفقات الخاص بالأداة المالية المحددة
دفق عروض الأسعار - يعرض دفق عروض الأسعار الحية للأداة المالية المحددة
الحصول على آخر سعر - إرجاع آخر سعر للأداة المالية المحددة.
التغيير - يتيح لك هذا الإذن تقديم الطلبات التالية:
الحصول على التغيرات اليومية - إرجاع قائمة التغيرات اليومية للأدوات المطلوبة
الطلبات - يتيح لك هذا الإذن تقديم الطلبات التالية:
استرداد الطلبات السابقة - عرض قائمة الطلبات السابقة
تقديم أمر (طلب POST) - تقديم أمر تداول جديد
الحصول على الأوامر النشطة - إرجاع قائمة أوامر التداول النشطة
استرداد الطلب - إرجاع الطلب ذي المعرّف المحدد
تعديل الأمر (طلب POST) - استبدال أو إلغاء أمر التداول
OHLC - يتيح لك هذا الإذن تقديم الطلبات التالية:
get OHLC (2.0) - إرجاع قائمة شموع OHLC للأداة المالية المحددة والفترة الزمنية المحددة
الحصول على وحدات التداول (2.0) - إرجاع قائمة وحدات التداول للأداة المالية المحددة
get OHLC (3.0) - تُرجع قائمة شموع OHLC للأداة المالية المحددة والفترة الزمنية المحددة
الحصول على وحدات التداول (3.0) - إرجاع قائمة وحدات التداول للأداة المالية المحددة
Crossrates - يتيح لك هذا الإذن إرسال الطلبات التالية:
الحصول على قائمة العملات المتاحة - إرجاع قائمة العملات المتاحة
الحصول على سعر الصرف المتبادل - إرجاع سعر الصرف المتبادل من عملة إلى أخرى
ملخص - يتيح لك هذا الإذن تقديم الطلبات التالية:
الحصول على ملخص الحساب - عرض ملخص الحساب المحدد
الحصول على ملخص الحساب حسب التاريخ - الحصول على ملخص الحساب حسب التاريخ
الحسابات - يتيح لك هذا الإذن تقديم الطلبات التالية:
الحصول على حسابات المستخدمين - إرجاع قائمة بحسابات المستخدمين وحالاتها
المعاملات - يتيح لك هذا الإذن تقديم الطلبات التالية:
استرداد المعاملات - إرجاع قائمة المعاملات وفقًا للفلتر المحدد.
ما هي متطلبات إنشاء مفاتيح واجهة برمجة التطبيقات (API) لـ HTTP؟
يرجى ملاحظة أن خيار إنشاء بيانات اعتماد واجهة برمجة التطبيقات (API) التجريبية عبر بروتوكول HTTP لا يصبح متاحًا إلا بعد الموافقة على حسابك.
يصبح الوصول إلى واجهة برمجة التطبيقات (API) لـ Live HTTP متاحًا بمجرد استيفاء شرط الإيداع البالغ 50,000 يورو.
لمناقشة أسعار الوصول إلى واجهة برمجة التطبيقات HTTP المباشرة، يرجى الاتصال بمدير حسابك. يمكن العثور على تفاصيل الاتصال بمدير حسابك في «منطقة العميل» → «الإعدادات» → «الملف الشخصي» → «المعلومات الشخصية» → «مدير الحساب الشخصي».
ما الغرض من استخدام مفتاح واجهة برمجة التطبيقات (HTTP API) والمفتاح السري؟
يُستخدم مفتاح واجهة برمجة التطبيقات (API) HTTP والمفتاح السري لتوثيق وصولك إلى واجهة برمجة التطبيقات. فهما يؤكدان هويتك ويضمنان اتصالاً آمناً بين نظامك والخادم لأغراض التداول وطلبات البيانات.
ملاحظة: من المهم أن تتذكر أن EXANTE لا تقدم أي مساعدة فيما يتعلق بالإعدادات الأولية اللازمة لتمكين اتصال واجهة برمجة التطبيقات (API) عبر بروتوكول HTTP على جهاز الكمبيوتر الخاص بك، كما أنها لا تتحمل أي مسؤولية عن جودة أي خدمات مقدمة من أطراف ثالثة.
ما الفرق بين «التفويض الأساسي» و«رمز JSON Web Token» في واجهة برمجة التطبيقات HTTP؟
يتطلب «التوثيق الأساسي» إرسال اسم المستخدم وكلمة المرور، مشفَّرين باستخدام Base64، مع كل طلب HTTP. ورغم أن هذه الطريقة بسيطة، إلا أنها أقل أمانًا.
في المقابل، يوفر JSON Web Token (JWT) طريقة مصادقة أكثر أمانًا. بعد المصادقة، يصدر النظام رمزًا (token) تستخدمه في جميع الطلبات اللاحقة. وهذا يلغي الحاجة إلى إرسال بيانات الاعتماد الحساسة بشكل متكرر. كما يمكن أن تتضمن رموز JWT مطالبات مدمجة، مما يدعم قواعد مصادقة وتفويض أكثر تعقيدًا.
يرجى ملاحظة أن صلاحية رموز JSON Web Tokens تنتهي بعد ست ساعات من إنشائها.
ما المقصود بـ«معرّف العميل» في واجهة برمجة التطبيقات HTTP؟
معرّف العميل هو معرّف فريد يُخصص لعميل أو مستخدم معين. وهو يعمل على مصادقة طلبات واجهة برمجة التطبيقات (API) وتحديد هويتها، مما يمكّن الخادم من التعرف على العميل الذي يرسلها. وغالبًا ما يُستخدم جنبًا إلى جنب مع مفتاح سري لضمان أمان الاتصال.
كم عدد المفاتيح التي يمكن إنشاؤها لواجهة برمجة التطبيقات (HTTP API) التجريبية والحقيقية؟
يمكنك إنشاء ما يصل إلى 30 مفتاحًا لكل من واجهات برمجة التطبيقات (API) HTTP الحية والتجريبية. كما يمكنك حذف هذه المفاتيح في أي وقت.
ما هي نقاط النهاية الخاصة بواجهة برمجة التطبيقات (API) HTTP الحية والتجريبية؟
هناك نوعان من نقاط النهاية لكل من واجهات برمجة التطبيقات (API) HTTP التجريبية والحقيقية:
نقطة نهاية تداول واجهة برمجة التطبيقات (API): يتيح عنوان URL هذا للمستخدمين إجراء الصفقات وتعديلها وإدارتها برمجيًّا عبر واجهة HTTP.
نقطة نهاية بيانات واجهة برمجة التطبيقات (API): يتيح عنوان URL هذا الوصول إلى بيانات السوق، بما في ذلك الأسعار في الوقت الفعلي والأسعار التاريخية والمعلومات المالية الأخرى، عبر واجهة HTTP.
فيما يلي نقاط النهاية لواجهة برمجة التطبيقات HTTP التجريبية والحقيقية:
مباشر | تجريبي |
نقطة نهاية واجهة برمجة التطبيقات (API) للتداول: https://api-live.exante.eu/trade/ | نقطة نهاية واجهة برمجة التطبيقات (API) للتداول: https://api-demo.exante.eu/trade/ |
نقطة نهاية بيانات واجهة برمجة التطبيقات (API): https://api-live.exante.eu/md/ | نقطة نهاية بيانات واجهة برمجة التطبيقات (API): https://api-demo.exante.eu/md/ |
ما هي حدود واجهة برمجة تطبيقات HTTP؟
تتسم واجهة برمجة التطبيقات (API) الحالية بالقيود التالية:
يجب ألا يتجاوز طول عنوان URL 2000 رمزًا
يتم تحديد الحد الأقصى لعمق الأوامر، سواء للأوامر المؤرشفة أو النشطة، من خلال الإعدادات (1000 بشكل افتراضي)
فيما يلي القيود المفروضة على واجهة برمجة تطبيقات HTTP التجريبية والحقيقية في الدقيقة الواحدة:
الرموز - 60
OHLC - 1
الخلاصة - 300
التغيير - 300
أسعار الصرف المتبادلة - 300
الطلبات - 300
ملخص - 60
الحسابات - 60
المعاملات - 60
هل يمكن زيادة حدود واجهة برمجة التطبيقات (API) لـ HTTP؟
نعم، يمكن زيادة حدود واجهة برمجة التطبيقات (HTTP API) للحسابات الحقيقية.
يمكنك تعديل حدود OHLC من خلال منطقة العميل في → الإعدادات → إدارة واجهة برمجة التطبيقات (API). حدد حسابك الحقيقي وانقر على «تغيير الحدود»، ثم اختر خيار الحدود المطلوب، وأكّد التغييرات.
زيادة حدود OHCL
للحصول على معلومات حول الزيادات الأخرى في الحدود، يرجى الاتصال بفريق خدمة العملاء عبر الدردشة أو البريد الإلكتروني على العنوان [email protected].
ماذا يحدث إذا تجاوزت الحد الأقصى لعدد المرات؟
إذا تجاوزت الحد الأقصى لمعدل الطلبات لأي من واجهتي برمجة التطبيقات (API)، فستتلقى استجابة خطأ "429 Too Many Requests". وقد يقوم النظام بتأخير طلباتك مؤقتًا أو رفضها حتى تعود إلى ضمن الحدود المسموح بها.
كيف يمكنني تجنب الوصول إلى الحد الأقصى لعدد الطلبات؟
قم بتطبيق آلية تحديد معدل الاستخدام في تطبيقك: أدخل فترات تأخير أو توقف مؤقت بين طلبات واجهة برمجة التطبيقات (API) للبقاء ضمن الحدود المسموح بها.
استخدم التخزين المؤقت: قم بتخزين استجابات واجهة برمجة التطبيقات (API) مؤقتًا كلما أمكن ذلك لتجنب إرسال طلبات متكررة للحصول على نفس البيانات.
الطلبات المجمعة: إذا كان ذلك ممكنًا، قم بدمج عدة طلبات في استدعاء واحد لواجهة برمجة التطبيقات (API) لتقليل العدد الإجمالي للطلبات.
الاتصال بشركة EXANTE: إذا كان طلبك يتطلب حدًا أعلى للسعر، فيُرجى الاتصال بمدير حسابك أو فريق خدمة العملاء لمناقشة احتياجاتك.