إنشاء اتصال¶
يمكنك الاتصال بـ وكيل cTrader Open API باستخدام بروتوكول TCP أو بروتوكول WebSocket. يغطي هذا الدليل كلا الخيارين.
استخدام TCP ¶
استخدام SSL
يجب أن يستخدم اتصال عميل TCP بروتوكول SSL، وإلا فلن تتمكن من الاتصال أو التفاعل مع واجهة برمجة التطبيقات API.
يمكنك إنشاء اتصال على النحو التالي باستخدام حزم تطوير البرمجيات SDK الرسمية لـ cTrader Open API.
1 2 | |
تستدعي طريقة OpenClient.Connect() طريقة OpenClient.ConnectTcp().
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | |
يحاول عميل Python Open API تلقائياً إنشاء اتصال عند تهيئته.
1 | |
عبر WebSocket ¶
عند الاتصال عبر بروتوكول WebSocket، يكون المضيف والمنفذ هما نفسهما عند الاتصال عبر بروتوكول TCP.
إليك كيف تقوم حزم تطوير البرمجيات SDK الرسمية لـ cTrader Open API بإنشاء اتصال عبر WebSocket.
1 2 | |
تستدعي طريقة OpenClient.Connect() طريقة OpenClient.ConnectWebSocket().
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | |
لا تدعم حزمة تطوير البرمجيات SDK لـ Python معيار WebSocket.
للاطلاع على مثال لتطبيق ويب .NET Blazor يستخدم معيار WebSocket لإنشاء اتصال والحفاظ عليه، انقر هنا.
أفضل الممارسات ¶
إليك بعض الإرشادات التي يجب أن تضعها في اعتبارك عند الاتصال بـ cTrader Open API:
- كحد أقصى، يجب عليك إنشاء اتصالين: واحد للحسابات التجريبية وآخر للحسابات الحقيقية. يمكن لكل اتصال دعم عدد غير محدود من الحسابات من نوع معين.
- بعد إنشاء الاتصال، يجب عليك اجتياز تدفق تفويض التطبيق. إذا قمت بإرسال أي رسائل قبل تفويض تطبيقك، ستتلقى رسالة خطأ.
- للحفاظ على الاتصال نشطاً، استمر في إرسال حدث نبض القلب (
ProtoHeartbeatEvent) كل 10 ثوانٍ. - استخدم قائمة انتظار الرسائل لإرسال واستقبال البيانات لتجنب أحداث الإرسال والاستقبال المتزامنة.