انتقل إلى المحتوى

SDK لإضافة WebView مقابل Open API

عند بناء تطبيقات الويب لإضافات WebView، يمكن للمطورين استخدام SDK لإضافة WebView أو Open API أو كليهما لتمكين التواصل بين خدماتهما على الويب ومنصة cTrader. سيساعدك هذا الدليل على فهم متى تستخدم كل منهما.

نظرة عامة

يقدم كل من SDK لإضافة WV و Open API قدرات قوية، ولكنهما يخدمان أغراضًا مختلفة من حيث النطاق، ونموذج الثقة والعمليات المسموح بها.

السمة SDK لإضافة WV Open API
سياق الاستخدام داخلي ومدمج في cTrader.
يستخدم في تطبيقات الويب لإضافات WebView.		 خارجي وعام، غير مرتبط بأي تدفق محدد.
يمكن استخدامه من قبل أي خدمة.
التوثيق يتم التوثيق تلقائيًا داخل cTrader. يتطلب توثيقًا إضافيًا أو رموز OAuth 2.0 مميّزة.
الأذونات إمكانيات كاملة بما في ذلك العمليات الحسّاسة. محدود للبيانات غير الحسّاسة.
الأداء قد تؤثر أحجام الطلب المفرطة على الإضافة. يتوسع لاستعلامات البيانات الكبيرة والتجميع.

القدرات المشتركة

بالنسبة لإضافات WebView، تتوفر بعض الوظائف من خلال كل من WV plugin SDK و Open API. يمكنك استخدام أيِّ منهما للقيام بما يلي:

  • الحصول على البيانات التاريخية
  • الحصول على معلومات الرمز
  • الاشتراك في عمليات التسعير
  • استرجاع بيانات الحساب (الرصيد ورأس المال).

تنفيذ استرجاع بيانات الحساب باستخدام SDK لإضافة WV يعني عمليات سلسة:

  • لا حاجة إلى رمز مميّز من المستخدم.

  • لا حاجة إلى تدفق تسجيل دخول منفصل.

  • يتم التعامل مع المصادقة تلقائيًا بواسطة cTrader.

عندما يعمل تطبيقك على الويب داخل cTrader كإضافة WebView، فإنه يرث جلسة المستخدم المصادق عليها. هذا الإعداد يجعل استرجاع بيانات الحساب أسرع، وأكثر أمانًا وسهولة في الاستخدام.

ملاحظة

تتيح SDK لإضافة WV للمطوّرين إنشاء تطبيقات ويب لإضافات WebView بالكامل باستخدام تقنيات الواجهة الأمامية (JavaScript وHTML وCSS)، أو إنشاء إضافات WV باستخدام الذكاء الاصطناعي. لن تضطر إلى تنفيذ أو صيانة خدمة خلفية.

إن تنفيذ استرجاع بيانات الحساب باستخدام Open API في تطبيقك على الويب يعني واحدًا أو أكثر من التالي:

  • يجب عليك تنفيذ تدفق OAuth 2.0 في تطبيقك.

  • يجب على المتداولين تسجيل الدخول إلى cTrader وتخويل تطبيقك.

  • يجب على المتداولين إنشاء رمز مميّز للوصول الشخصي وتقديمه.

تحذير

بالرغم من أن Open API أيضًا يدعم استرجاع بعض بيانات الحساب، إلا أنه يأتي مع قيود لمطوّري إضافات WV. تؤدي خطوة المصادقة الإضافية إلى تعقيد التطوير، وتعطيل تجربة المستخدم، وقد تثني عن اعتماد منتجك.

الفروق الرئيسية

يمكن لتطبيقات الويب تنفيذ إجراءات التداول المختلفة في cTrader باستخدام SDK لإضافة WV، بينما لا يدعم Open API هذه الوظائف لإضافات WebView.

عملية إضافة WV SDK لإضافة WV Open API
إنشاء أوامر جديدة نعم لا
تعديل الأوامر الموجودة نعم لا
إلغاء الأوامر نعم لا
إغلاق المراكز نعم لا
تعديل حماية SL/TP نعم لا
التنقل بين الشاشات نعم لا

تحذير

تعمل إضافات WebView دون الوصول إلى أي معلومات شخصية للمستخدم أو نقلها، مثل أسماء المستخدمين أو معرفات الحساب. بالرغم من أنه يمكن للإضافات الوصول إلى بيانات الحساب المحدودة (مثل الرصيد) عند الاتصال النشط في بيئة cTrader، إلا أنها لا تخزِّن ملفات تعريف الارتباط في أي وقت.

تحد منصة cTrader من العمليات الحسّاسة إلى بيئة المنصة، حيث:

  • لقد قام المستخدم بتثبيت أو تمكين الإضافة بشكل صريح.

  • يمكن للمنصة فرض تدفقات تأكيد إضافية.

  • يتم تشغيل حدود المراكز، وفحوصات الهامش، وقواعد المخاطر محليًا قبل إرسال الطلب.

لا يمكن لموقع ويب خارجي يستخدم Open API ضمان نفس مستوى التحكم والأمان؛ لذلك، لا يمكن كشف نقاط النهاية المتعلقة بالتداول هناك.

ملخص

استخدم SDK الخاصة بإضافة WebView في تطبيقات الويب التي سيتم استخدامها من أجل بناء إضافة WebView، خاصة إذا كان تطبيق الويب يحتاج إلى التداول أو التعامل مع بيانات حساب معيّنة.

استخدم Open API في تطبيقات الويب التي تعمل خارج cTrader وتعتمد على البيانات العامة.