MT5 Manager API أم Web API أم Server API

ما هي MT5 Manager API؟

واجهة MT5 Manager API هي ما توفره MetaQuotes لكتابة برامج الإدارة والتشغيل الخاصة بك لخادم MetaTrader 5. فكل ما يقوم به موظف المكتب الخلفي في منصة MT5 Manager، من فتح الحسابات ونقلها بين المجموعات وتسجيل الإيداعات ومراقبة الصفقات ومعالجة طلبات المتعاملين، يمكن من حيث المبدأ تنفيذه من برنامج مبني عليها.

وتُقدَّم لحاملي التراخيص ضمن حزم المطوّرين من MetaQuotes، لا بوصفها تنزيلًا متاحًا للعموم، وتوجد وثائقها على موقع الدعم لدى MetaQuotes خلف تسجيل الدخول. وفي الحزم التي عملنا بها، كانت مكتبة أصلية لنظام Windows مع ملفات ترويسة (Headers) للغة C++ وأغلفة برمجية لمنصة .NET؛ لكن راجع الحزمة الحالية الخاصة بإصدار خادمك، لأن التفاصيل تتغير.

كيف تقارن Manager API وWeb API وServer API؟

أسرع طريقة للتمييز بينها أن تسأل: أين تعمل الشيفرة، وماذا يحدث إذا تعطلت؟ فبرامج Manager API وWeb API تعمل خارج الخادم وتتصل به، أما إضافة Server API فتعمل داخله، وتُستدعى عند كل حدث ذي صلة.

وأين تقع Gateway API وReport API؟

تكمّلان المجموعة، لكنهما تجيبان عن أسئلة مختلفة. فواجهة Gateway API تربط MT5 بأنظمة التداول الأخرى وبتدفقات البيانات، وبها يُربط مزوّدو السيولة والبورصات؛ ونتناولها في دليل MT5 Gateway API. أما Report API فتوسّع التقارير التي يُصدرها خادم التداول، وهو أمر مهم للتقارير الرقابية والإدارية.

ولا تغني أيٌّ منهما عن Manager API أو Web API. فنظام CRM الذي يحتاج إلى فتح الحسابات لن يستخدم Gateway API أبدًا، ولن يُبنى اتصال بالسيولة على Web API أبدًا.

ما الذي يؤتمته الوسطاء عبر Manager API؟

يستخدم الوسطاء Manager API في الغالب للأعمال التي كان موظفوهم سيؤدونها يدويًا في منصة Manager، حين تكبر أحجامها أو تلزم على مدار الساعة. ومن الأمثلة الشائعة في المشاريع التي اطلعنا عليها:

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

مثال تطبيقي: من اعتماد التحقق من الهوية (KYC) إلى أول صفقة

لنفترض أن وسيطًا اعتمد عميلًا جديدًا في نظام CRM لديه عند العاشرة صباح يوم ثلاثاء. هكذا يتوزع العمل بين الواجهات في عملية ربط نموذجية؛ وفي نظام CRM يعمل على الويب، كنظامنا، تمر الاستدعاءات التي تتطلب صلاحيات المدير عادةً عبر Web API.

1. اعتماد التحقق من الهويةيعتمد مسؤول الامتثال المستندات في نظام CRM، فيتحقق النظام من دولة العميل ويحدد له مجموعة MT5 المناسبة.
2. إنشاء الحسابيستدعي نظام CRM الخادم بصفة مدير لإنشاء الحساب بالاسم والمجموعة والرافعة المالية وكلمة مرور مولّدة، ثم يعرض بيانات الدخول في بوابة العملاء.
3. إضافة الإيداعيؤكد مزوّد خدمات الدفع إيداعًا بالبطاقة. وبعد الفحوص التي يجريها نظام CRM، تُسجَّل عملية رصيد على الحساب مع مرجع الدفع في خانة التعليق.
4. تداول العميليسجّل العميل الدخول إلى منصة WebTrader أو التطبيق ويفتح صفقة. وفي هذه اللحظة يمكن لإضافة Server API، إن كانت لدى الوسيط، أن تطبّق قواعد مخصصة.
5. التقاريرخلال الليل، تقرأ مهمة التقارير صفقات اليوم لحساب عمولات الوسطاء المعرّفين ولتحديث لوحة فريق المخاطر.

متى تكون Web API خيارًا أفضل من Manager API؟

تكون Web API عادةً الخيار الأفضل حين يكون المستخدم خدمة ويب تعمل على Linux، أو في السحابة، أو بلغة غير C++ أو .NET. فهي تعمل عبر HTTPS وJSON، فيستطيع نظام CRM مكتوب بـ PHP أو Node.js أو Go أو Python استخدامها دون مكتبة أصلية. ولهذا تُبنى عليها معظم أنظمة CRM والبوابات، ومنها نظامنا.

أما Manager API فتستحق مكانها حين تبني أداة سطح مكتب للمتعاملين، أو تحتاج إلى جميع وظائف المدير في تطبيق أصلي، أو تريد التفاعل مع أحداث الخادم دون استعلام دوري. ومراقب المخاطر الذي يجب أن يعرض تغيّر الانكشاف لحظة بلحظة مثال نموذجي على ذلك. ويشرح دليلنا عن MetaTrader 5 Web API حدود Web API بتفصيل أكبر.

ما إضافة MT5 Server API، ومتى تحتاج إليها؟

إضافة Server API شيفرة تعمل داخل خادم التداول أو خادم السجل في MetaTrader 5، وتُستدعى عند وقوع الأحداث: طلب تداول، أو صفقة منفذة، أو تغيير في حساب. وتحتاج إليها حين يجب فرض قاعدة على كل عملية قبل أن تصبح نتيجتها نهائية، ولا يمكن انتظار برنامج خارجي حتى يلاحظ ما حدث.

ومن الأمثلة فحوص مخصصة للهامش أو الانكشاف، وقواعد مكافآت تعتمد على حجم التداول، ومنطق نسخ تداول يجب أن يتفاعل فورًا، أو بيانات إضافية تُكتب على الصفقات لأغراض التقارير. لكن مصدر القوة هنا هو نفسه مصدر الخطر: فالإضافة البطيئة أو المعيبة تُبطئ الخادم أو توقفه على الجميع. لذلك ننصح عملاءنا بأن تبقى الإضافات صغيرة، وأن تُختبر على خادم منفصل تحت حمل واقعي، وأن يبقى خارج الخادم كل ما يمكن تشغيله خارجه.

أي واجهة MT5 API تستخدم لكل مهمة في شركة الوساطة؟

اختر الواجهة بحسب المهمة، لا بحسب ما يعرفه مطوّرك مسبقًا. ويعكس الجدول التالي الطريقة التي سنبني بها كل بند اليوم.

من يمكنه الحصول على صلاحية الوصول إلى MT5 Manager API؟

يأتي الوصول من مالك خادم MT5، لأن كل حساب مدير يُنشأ على ذلك الخادم. فمع ترخيص MT5 خاص بك تقرر أنت من يحصل على أي حساب مدير، وأي حزم المطوّرين تستخدم. وفي الوايت ليبل (White Label) يقرر حامل الترخيص، ويكون حساب المدير الذي تتسلمه عادةً مقصورًا على مجموعاتك. أما في جراي ليبل MT5 (Grey Label) فتعمل في الغالب من خلال نظام CRM وواجهات العملاء لدى المزوّد، دون أن تحمل بيانات دخول المدير مباشرة.

وهذه من المسائل التي يجب حسمها قبل التوقيع. فإن كانت خططك تشمل أداة تداول مخصصة أو نظام CRM داخليًا، فاسأل مزوّدك كتابيًا عن مستوى الوصول إلى الواجهات البرمجية الذي ستحصل عليه وبأي شروط. ونحن شركة مستقلة لا ترتبط بشركة MetaQuotes؛ وفي ما يخص أسئلة الترخيص المتعلقة بحزم الواجهات البرمجية نفسها، فالجهة المناسبة هي MetaQuotes أو مزوّد خادمك. وإن كنت تتقدم بطلب ترخيص MT5 خاص بك، فنتولى متطلبات MetaQuotes والطلب لعملائنا بوصفه خدمة استشارية مدفوعة.

لست متأكدًا مما تطلبه؟ أرسل إلينا رسالة عبر واتساب تصف فيها إعدادك، وسنقترح عليك الصياغة.

وماذا عن خدمات "MT5 API" التي تقدّمها أطراف ثالثة؟

كثير من المنتجات التي تُباع باسم "MT5 API" ليست من الواجهات البرمجية التي تقدّمها MetaQuotes للوسطاء أصلًا. فبعضها يتصل بحسابات تداول فردية عبر تشغيل منصات على سحابة المزوّد، وبعضها يغلّف حزمة Python من MetaQuotes التي تتواصل مع منصة سطح مكتب على الجهاز نفسه. وهذه تناسب المتداولين وخدمات الإشارات والتحليلات، وتعمل مع حسابات أي وسيط.

وهناك منتجات أخرى هي أغلفة مستضافة لـ Manager API أو Web API، تقدّم واجهة REST فوق اتصال بصلاحيات المدير. وقد توفر عليك وقت التطوير، لكن بيانات دخول المدير تصبح عندئذ لدى طرف ثالث، وتعتمد على استمرارية خدمته وعلى دورة تحديثاته كلما أصدرت MetaQuotes إصدارًا جديدًا. فاسأل أين تُستضاف الخدمة، ومن يستطيع رؤية بيانات الدخول، وما مصير عملية الربط لديك إذا توقف المزوّد عن العمل.

كيف تحافظ على أمان عملية ربط بصلاحيات المدير؟

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

• حساب مدير واحد لكل عملية ربط، بالصلاحيات والمجموعات التي تحتاجها تلك العملية فقط.
• عمليات الرصيد من قائمة معتمدة فقط، وليس مباشرة من أي طلب يصدر عن واجهة العملاء.
• حفظ بيانات الدخول في مخزن للأسرار، وتغييرها عند تغيّر الموظفين أو المزوّدين.
• السماح بالاتصال من خوادم معروفة فقط.
• تسجيل كل عملية كتابة مع سببها التجاري، ومطابقتها يوميًا.
• عدم إعادة أي حركة أموال أو صفقة تلقائيًا بعد انتهاء المهلة؛ وتحقق من حالة الخادم أولًا.

ما الأخطاء الشائعة في مشاريع MT5 Manager API؟

الأخطاء الشائعة معمارية في الأساس، ومعظمها يقع في الأسبوع الأول. وتجنّبها رخيص، بينما إصلاحها مكلف بعد أن يعتمد العملاء على النظام.

• حساب مدير واحد لكل شيء. يتشارك نظام CRM ومهمة التقارير وأداة المتعاملين حساب دخول واحدًا بصلاحيات كاملة، فلا يعرف أحد أي نظام أجرى التغيير، ولا يمكن إلغاء صلاحية أي منها على حدة.
• الاستعلام حسابًا بعد حساب. البوابة التي تطلب صفقات كل عميل بالتتابع تعمل مع 50 حسابًا، وتُبطئ الخادم مع 5,000. استخدم الطلبات المجمّعة، وخزّن مؤقتًا ما لا يتغير.
• منطق العمل داخل إضافة. قاعدة نسخ التداول أو المكافآت تُكتب إضافةً على Server API لأنها بدت "أقرب إلى الخادم"، في حين كان يمكن تشغيلها خارجه بأمان.
• تجاهل توقيت الخادم. تُحفظ الصفقات في نظام CRM بتوقيت الخادم وتُقارن بسجلات الدفع بتوقيت UTC، فتأتي المطابقات اليومية بفارق ساعتين أو ثلاث.
• إعادة محاولة حركات الأموال. تنتهي مهلة استدعاء الإيداع، فتعيد الشيفرة المحاولة، ويُضاف المبلغ إلى حساب العميل مرتين. راجع سجل الحساب قبل أي إعادة محاولة.
• غياب خطة لتحديثات MT5. تُصدر MetaQuotes إصدارات جديدة بانتظام. احتفظ بخادم اختبار على الإصدار التالي، وشغّل عملية الربط عليه قبل تحديث الخادم الحقيقي.

هل يغيّر مشروع شركة تداول ممول أو نسخ تداول هذا الاختيار؟

نعم، قليلًا. فـتقنيات شركات التداول الممول تعتمد كثيرًا على إجراءات سريعة مبنية على قواعد على الحسابات، كإغلاق حساب تحدي التقييم لحظة تجاوز حد التراجع مثلًا. وبعض الشركات تنفذ ذلك من الخارج عبر Web API أو Manager API بفحوص متكررة، بينما تفضّل أخرى إضافة برمجية لتُفرض القاعدة داخل الخادم. والمفاضلة هنا بين سرعة الاستجابة ومخاطر تشغيل شيفرة مخصصة على الخادم.

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

كيف تعمل FXUP مع واجهات MT5 API؟

تتصل منصة WebTrader بعلامتك وتطبيقات الجوال ونظام CRM للوسطاء من تطويرنا بـ MT5 عبر خادم خلفي بلغة Go يستخدم Web API. ونعمل أيضًا مع أنظمة CRM من شركائنا، ونقترح ما يناسب المشروع منها؛ وفي الحالتين نتحقق من الواجهة وصلاحيات المدير التي يحتاجها نظام CRM قبل بدء التشغيل. ولعملائنا الذين يملكون خوادمهم نحدد أيضًا نطاق أدوات المتعاملين ومهام التقارير، وأحيانًا إضافة برمجية، وسنخبرك حين تكون إحدى مزايا MT5 القائمة أو واجهة أبسط كافية لأداء المهمة.

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

أسئلة شائعة

لم تجد إجابة سؤالك هنا؟ اسألنا عبر واتساب, أو راسل @FXUPCK على تيليجرام، أو اكتب إلى [email protected].