اقتراح: واجهة برمجة تطبيقات HTTP اختيارية من طرف ثالث لـ TradeBot

هذا الاقتراح يقدم واجهة برمجة تطبيقات Bot API v1 اختيارية، تسمح للعملاء الخارجيين—مثل واجهة ويب رسومية (WebUI)—بمراقبة والتحكم في بوت تداول دون الاعتماد على ADAMANT Messenger أو Telegram. في هذا المعمّد، تتواصل الواجهة الرسومية (WebUI) حصريًا مع واجهة برمجة التطبيقات الخاصة بالبوت، مما يضمن بقاء البوت كمصدر وحيد وموثوق للبيانات السوقية (مثل السعر الحالي، دفتر الطلبات، الصفقات، OHLC)، وحالة الحساب، ومعايير التداول، وتنفيذ الأوامر.

تهدف واجهة برمجة التطبيقات إلى توفير واجهة HTTP وWebSocket واردة اختيارية على البوت، باستخدام منفذ private_webui في التهيئة. سيتم التعامل مع المصادقة عبر JWT، يتم التحقق منها على البوت باستخدام private_webui_secret_key، بينما تبقى حسابات المستخدمين في العميل الخارجي. ستُعرض عبر واجهة برمجة التطبيقات نقاط نهاية منظمة بصيغة JSON للبيانات السوقية، وبيانات الحساب، ومعايير التداول، إضافة إلى أدوات تنفيذ الأوامر. ستُستخدم نقطة النهاية GET /bot كخطوة تمهيدية (bootstrap)، وتعيد قدرات مثل وحدات mm_*.js المثبتة وأعلام ميزات البورصات. بالنسبة للتغييرات الحية في معايير التداول، ستتوفر رسالة WebSocket باسم params:updated. في البداية، ستدعم أوضاع النقل directHttp للعملاء المُستضافين ذاتيًا، مع تخطيط لدعم relayWs للاستضافة عن طريق الاشتراك في مرحلة لاحقة.

هذا النقاش لا يشمل واجهات الدفع أو الفوترة أو الترخيص، ولا تفاصيل تنفيذ محددة للواجهة الرسومية (WebUI). يُدعى المجتمع إلى إبداء الملاحظات حول ما إذا كان ينبغي أن تكون هذه الواجهة في مستودع adamant-tradebot المفتوح المصدر كوحدة اختيارية، وأي نقاط نهاية ضرورية لعميل مفيد بأدنى حد تتجاوز أوامر المراسلة، وما إذا كان يُفضل استخدام الاستطلاع (polling) أو الدفع (push) للبيانات السوقية وبيانات الحساب في الإصدار الأول. سيتم فتح مشكلة تتبع في adamant-tradebot تشير إلى هذا النقاش. حاليًا، يجري العمل على تنفيذ مرجعي متميز على الفرع refactor/new-webui-api في adamant-tradebot-me.