R | Protocol (واجهة Rithmic البرمجية)

كيف تُبنى الواجهة البرمجية

يتصل العميل ببوابة Rithmic عبر عنوان WebSocket آمن، ثم يطلب قائمة الأنظمة التي تخدمها تلك البوابة، ثم يسجّل الدخول إلى نظام واحد باسم مستخدم وكلمة مرور. ومن هناك يفتح جلسات منفصلة إلى الخوادم plants التي يحتاجها: بيانات السوق للصفقات والعمق، وتوجيه الأوامر للحساب، والسجل للتيكات أو الشموع الماضية، والأرباح والخسائر. ولكل جلسة صلاحيتها الخاصة تمنحها الشركة التي أصدرت حساب الدخول.

ولأن البروتوكول مكشوف لبرمجيات خارجية، تتحكم Rithmic والشركة المصدِرة في من يجوز له استعماله. فتطبيقات البائعين مسجَّلة ومسمّاة؛ وقد يُسمح لحساب بتطبيق دون آخر، والتجربة التجريبية غير مقدَّمة على الواجهة البرمجية أصلًا.

• البوابة: نقطة الوصول، تُختار بحسب الجغرافيا؛ وبعضها للاستضافة المشتركة فقط.
• اسم النظام: يحدّد بيئة الوسيط أو شركة التمويل على تلك البوابة.
• الخوادم plants: جلسات دخول مستقلة لكل منها نبضاتها وأذوناتها.

ما لا يثبته الدخول عبر الواجهة البرمجية

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

داخل Senzoukria

ينفّذ التطبيق المكتبي R | Protocol مباشرةً، بلا جسر، على بطاقة اتصال Rithmic Direct. وتُظهر البطاقة عنوان البوابة، الذي يجب أن يبدأ بـ wss://، وقائمة نقاط وصول فيها مدخل مخصص، وإجراء جلب قائمة الأنظمة الحية من البوابة يستعلم البوابة قبل أن تختار اسم النظام. وتذهب بيانات الاعتماد إلى سلسلة مفاتيح نظام التشغيل، ولا ينبغي كتابتها أبدًا في نموذج على موقع ويب.

وتشرح ملاحظة على البطاقة نفسها أن حساب Rithmic التجريبي المجاني لا يستطيع الاتصال لأن Rithmic لا تقدّم واجهة R | Protocol للحسابات التجريبية، وأن قبول R | Trader Pro لحساب الدخول نفسه لا يغيّر ذلك. ومتى نجح الدخول ولم يصل أي تيك، سرد تشخيص الاتصال الأسبابَ المحتملة بحسب تواترها بدل عرض رسم فارغ، لأن سوقًا مغلقة وتغذية معطّلة تبدوان متطابقتين على الشاشة. ويُعرض إسناد Rithmic الذي يشترطه المزوّد في صفحة حول.

أخطاء شائعة

• إدخال بوابة R | Trader Pro وتوقّع أن تكون بوابة الواجهة البرمجية هي نفسها.
• اختيار اسم نظام من الذاكرة بدل جلب القائمة الحية.
• قراءة طلب سجل مرفوض على أنه خلل في الرسم.
• تقاسم حساب دخول واحد للواجهة البرمجية بين تطبيقين بينما تحدّ الشركة الجلسات المتزامنة.