كيف يحوّل API المفتوح لـ Foreso سوق التنبؤ إلى نظام بيئي للمطورين هناك لحظة في نضج كل منصة مالية جادة عندما تتوقف عن كونها منتجًا وتبدأ في كونها بنية تحتية. تأتي تلك اللحظة عندما تفتح المنصة وظائفها الأساسية أمام المطورين الخارجيين من خلال واجهة برمجة تطبيقات عامة، داعيةً المُنشئين إلى إنشاء تطبيقات وأدوات وتكاملات على أساس ما بنته المنصة بالفعل. لـ @ForesoGlobal، قد وصلت تلك اللحظة. دليل تكامل واجهة برمجة التطبيقات المفتوحة لـ Foreso متاح الآن، وما يصفه ليس مجرد تدفق بيانات محدود أو واجهة استعلام قراءة فقط للسوق. بل هو واجهة برمجة تطبيقات للتداول كاملة، مُصادَق عليها، وآمنة كryptographically، تمنح المطورين وصولًا برمجيًا كاملاً إلى كل الوظائف الأساسية على المنصة. هذا مهم ليس فقط كإنجاز تقني، بل كإشارة استراتيجية حول ما تبنيه Foreso. المنصات التي تفتح واجهات برمجة تطبيقاتها في هذه المرحلة من التطور تُرسل رسالة واضحة: إنها تبني من أجل نظام بيئي، وليس فقط من أجل جمهور. إنها تدعو المُنشئين إلى توسيع المنصة في اتجاهات لم تتوقعها فريقها الأساسي، وإنشاء أدوات تخدم شرائح مستخدمين محددة، ودمج بنية تحتية سوق التنبؤ الخاصة بـ Foreso في تطبيقات تصل إلى جماهير جديدة. إن واجهة برمجة التطبيقات هي الخطوة الأولى لجعل Foreso الطبقة الأساسية لعالم أوسع من منتجات سوق التنبؤ. ما الذي تمكنه واجهة برمجة التطبيقات فعليًا تغطي واجهة برمجة التطبيقات المفتوحة لـ @ForesoGlobal دورة الحياة الكاملة للمشاركة على المنصة. بدءًا من طلب مفتاح API والتوثيق، مرورًا بتهيئة المحافظ وفحص الهوية القائم على JWT، وحتى تقديم الأوامر باستخدام التوقيع التشفيري EIP-712، واستعلامات رصيد الأصول، وطلب المكافآت. يمكن لأي مطور يتكامل مع هذه الواجهة بشكل كامل بناء تطبيق تداول كامل لسوق التنبؤ على بنية Foreso دون اللجوء إلى واجهة الويب الخاصة بـ Foreso إطلاقًا. تم بناء بنية التوثيق على نظام توقيع HMAC-SHA256 مكوّن من ثلاثة رؤوس. يجب أن يتضمن كل طلب API معرف مفتاح API، طابع زمني Unix، وتوقيع طلب محسوب من طريقة HTTP، مسار النقطة النهائية، الطابع الزمني، وجسم الطلب. يتم حساب التوقيع باستخدام HMAC-SHA256 مع المفتاح السري، ويُرسل كسلسلة سداسية عشرية مسبوقة بـ sha256=. يضمن هذا التصميم أن كل طلب موثق، مُوقّع زمنيًا، وقابل للكشف عن أي تعديل. تقوم الخادم بفرض تحمل انحراف الساعة بمقدار ±3 ثوانٍ، مما يمنع هجمات إعادة الإرسال مع التسامح مع الانحراف المعقول في توقيتات العميل والخادم. بنية المحافظ: EOA و Safe Proxy أحد أكثر جوانب واجهة برمجة التطبيقات لـ #Foreso تطورًا من الناحية المعمارية هو نموذج المحافظ المزدوج. يعمل كل مستخدم مع محفظة EOA أولية، وهي الحساب الخارجي الذي يوقّع المعاملات، ومحفظة Safe Proxy، وهي العنوان الذي يحتفظ بالاصول فعليًا ويُدرج كصانع في الأوامر. تم اشتقاق هذا التصميم من إطار عمل Gnosis Safe متعدد التوقيعات، ويقدم خصائص أمان ذات أهمية لا توفرها نموذج المحفظة الفردية البسيطة. يتم إنشاء محفظة Safe Proxy من خلال نقطة النهاية enable-trading، ويجب أن تخضع لسلسلة تهيئة من ثلاث خطوات قبل أن يمكن استخدامها للتداول: تمكين وحدة التداول، تمكين وحدة التبادل CTF المحددة عبر سير عمل توقيع EIP-712 SafeTx، وإعداد قائمة البيضاء للعناوين المقبولة للمستندات. تتطلب كل خطوة من هذه الخطوات عمليات توقيع تشفيرية محددة، ويتضمن دليل واجهة برمجة التطبيقات ملاحظات تقنية مهمة يجب على المطورين اتباعها بدقة لتجنب فشل التحقق من التوقيع. تتضمن خطوة قائمة البيضاء متطلبًا غير واضح: يجب ترك قيمة nonce العائدة من نقطة النهاية prepare مُزاحة إلى اليسار بمقدار 12 بت قبل استخدامها في عملية توقيع EIP-712. وهذا يعني أن nonce_for_signing يساوي قيمة nonce الصحيحة المزاحة إلى اليسار بمقدار 12 بت. بالإضافة إلى ذلك، يستخدم هيكل EIP-712 اسم الحقل deadline بينما يستخدم معلمة واجهة برمجة التطبيقات expiration. هذه هي أنواع التفاصيل التنفيذية التي يسهل إغفالها، ويوضح الدليل هذه التفاصيل بدقة — وهو بالضبط ما يجب أن يفعله دليل التكامل الجيد. تقديم الأوامر وتوقيع EIP-712 نقطة النهاية لتقديم الأوامر هي الجزء الأكثر طلبًا تقنيًا في التكامل. يتم تقديم الأوامر عبر POST إلى /v1/orders وتتطلب التوثيق عبر JWT والتوقيع عبر API في آنٍ واحد. تتضمن بنية الأمر معرف السوق، معرف الخيار، معرف المركز، الكمية، الأسهم، السعر، الجانب، ونوع الأمر، بالإضافة إلى توقيع EIP-712 ورسالة التوقيع. أبرز ملاحظة تقنية في المستند بأكمله تتعلق بكيفية بناء توقيع أمر EIP-712. يحذر الدليل صراحةً من أن المطورين لا يجب أن يستخدموا طريقة encode_typed_data لبناء توقيع الأمر. بدلاً من ذلك، يجب بناء التوقيع باستخدام الترميز ABI اليدوي. السبب في هذا الشرط هو أن التحقق من التوقيع على السلسلة يستخدم تنسيق ترميز محدد، ولا تنتج طريقة المساعدة encode_typed_data في مكتبات Ethereum الشائعة ناتجًا يتطابق مع ما يتوقعه المدقق على السلسلة. أي مطور يغفل هذه الملاحظة ويستخدم المساعد القياسي سيُنتج توقيعات فاشلة دائمًا عند التحقق. يتطلب الأمر أيضًا ضبط حقل signatureType على القيمة 2، والتي تشير إلى نوع التوقيع SAFE، المقابل لبنية محفظة Safe Proxy. يجب أن يكون حقل maker هو عنوان محفظة Safe Proxy وليس عنوان EOA، حتى لو كان EOA هو الكيان الذي يقوم فعليًا بالتوقيع عبر حقل signer. إدارة الرصيد وحساب الاقفال توفر واجهة برمجة التطبيقات ملاحظة عملية وهامة حول إدارة الرصيد يحتاج كل مطور يتكامل مع وظيفة التداول إلى فهمها. الرصيد المتاح الفعلي للمحفظة ليس ببساطة إجمالي USDT على السلسلة. تقوم الأوامر المفتوحة بحجز جزء من الرصيد مقابل التسوية المستقبلية، ولا تعكس هذه الكميات المحجوزة في الإجمالي الخام على السلسلة. أي مطور يستعلم فقط عن الرصيد على السلسلة ويستخدم هذا الرقم لتحديد الأموال المتاحة سيُبالغ في تقدير الرصيد المتاح وسيواجه أخطاء "الرصيد غير كافٍ" عند تقديم الأمر. يتطلب الحساب الصحيح استعلام كل من الإجمالي على السلسلة وقيمة pending_buy_usdt من نقطة النهاية query_lock_balance. الرصيد المتاح الحقيقي يساوي إجمالي USDT على السلسلة ناقص pending_buy_usdt. إن دمج هذا الحساب في أي تطبيق تداول ليس اختياريًا. إنه الفرق بين تطبيق يعمل بشكل موثوق وتطبيق يولد أخطاءً مربكة يصعب تشخيصها. لماذا هذا مهم بالنسبة لنظام Foreso البيئي إن فتح واجهة برمجة التطبيقات لـ @ForesoGlobal يمثل بداية فصل جديد للمنصة. يمكن الآن للمتداولين الخوارزميين بناء استراتيجيات منهجية تعبر عن تقديرات الاحتمالات برمجيًا عبر العديد من الأسواق في آنٍ واحد. يمكن للمطورين بناء تطبيقات محمولة، وإضافات للمتصفح، وأدوات تتبع المحافظ، وأدوات تحليلية تسحب بيانات السوق الحية وتتفاعل مع بنية التداول الخاصة بالمنصة. يمكن للمنصات الخارجية دمج وظائف سوق التنبؤ الخاصة بـ Foreso في منتجاتها الحالية، وإعادة توجيه مستخدميها إلى أسواق Foreso دون الحاجة إلى زيارة واجهة Foreso مباشرة. كل واحدة من هذه الاستخدامات توسع نطاق المنصة وتعمق سيولتها. المزيد من المشاركة الخوارزمية يعني دفاتر أوامر أكثر نشاطًا وأسعارًا أكثر دقة. المزيد من التكاملات الخارجية يعني المزيد من المستخدمين الذين يكتشفون ويشاركون في أسواق Foreso.كلما زادت أدوات المطورين، انخفضت الحواجز أمام الموجة القادمة من المُبنين الذين يرغبون في التفاعل مع المنصة برمجيًا. الواجهة البرمجية (API) نشطة. الوثائق مفصلة. البنية التحتية جاهزة. للمطورين الذين كانوا يراقبون #Foreso وينتظرون اللحظة المناسبة للبناء، هذه اللحظة هي الآن. ابدأ التداول والبناء على Foreso https://t.co/cfQVL9FGFG