- الصفحة الرئيسية
- /
- مدونة
- /
- دليل تكامل واجهات برمجة تطبيقات تداول العملات المشفرة
دليل تكامل واجهات برمجة تطبيقات تداول العملات المشفرة
خطّط لتكامل API لتداول العملات المشفرة يشمل بيانات السوق والتسعير والتنفيذ. يتضمن فحوص الاعتماد واستعادة الأوامر ومصفوفة اختبارات الإطلاق.
حدّد دورة حياة الصفقة كاملة
- افصل متطلبات بيانات السوق والتسعير والتنفيذ.
- احتفظ بمعايير الصفقة التي تمت مراجعتها ومرجع الإرسال الأصلي.
- طابق التنفيذات والرسوم والنتائج غير المحسومة قبل إعادة محاولة التنفيذ.
محور التكامل
اربط الصفقة التي تمت مراجعتها بسجلات تنفيذها وسجلاتها المالية.
الافتراضات: تحقّق من وصول المزوّد والصلاحيات والأدوات المالية المدعومة قبل التنفيذ.
مثال العملية ومصفوفة القبول تصميمان مرجعيان أصليان. توثّق المصادر السلوكيات المحددة للمزوّدين التي يذكرها الدليل.
اختر بيانات السوق أو التسعير أو التنفيذ
ابدأ بالإجراء الذي يجب أن يدعمه منتجك. تحتاج لوحة الأسعار إلى تدفّق بيانات. وتحتاج شاشة المبادلة إلى عرض سعر لمبلغ ومسار محددين. ويحتاج منتج التداول أيضًا إلى التفويض والإرسال وسجل النتيجة. دوّن هذه المتطلبات منفصلة قبل اختيار واجهة API.
أبقِ منصة المصدر والحساب واضحين في التصميم. يمكن لمنصة مركزية قبول أمر وتنفيذه على أجزاء. أما المبادلة على السلسلة فتحتاج إلى معاملة موقّعة وتأكيد الشبكة. حدّد الحالات التي ستعرضها الواجهة للمسار الذي تنفّذه فعليًا.
| نطاق واجهة API | متطلب المنتج | أدلة للاحتفاظ بها |
|---|---|---|
| بيانات السوق | عرض الأسعار أو دفاتر الأوامر مع مؤشرات حداثة البيانات | المنصة والأداة المالية ووقت المصدر ووقت الاستلام |
| اقتباس | معاينة مبلغ الصفقة ومسارها المختارين | معرّفات الأصول والرسوم والحدود وشروط الصلاحية |
| التنفيذ | إرسال صفقة مفوّضة ومطابقة نتيجتها | معرّف العملية ومرجع الأمر أو المعاملة والتنفيذات والرسوم |
وضّح هوية الأداة المالية وحداثة البيانات
الرمز المختصر تسمية للعرض. احفظ معرّف الأداة لدى المنصة أو معرّفات الأصل والشبكة اللازمة للتنفيذ. احتفظ بأصل الأساس وأصل التسعير ووحدات المبلغ والدقة المحددة. استخدم سلاسل عشرية دقيقة أو وحدات أساسية صحيحة للقيم المالية طوال التكامل.
لدفتر أوامر مباشر، اتبع قواعد اللقطات والتحديثات لدى المصدر. توثّق Kraken قناة من المستوى الثاني تجمع الكمية عند كل مستوى سعري. ويشرح دليل المجموع الاختباري كيفية التحقق من الدفتر المحفوظ. عند فشل التحقق أو إعادة الاتصال، أظهر أن البيانات قديمة وأعد بناء الدفتر وفق البروتوكول قبل استخدامه مجددًا.
راجع عرض السعر وصلاحيات التوقيع
قبل أن يفوّض المستخدم الصفقة، اعرض الأصول والشبكة ومبلغ الإدخال والناتج المتوقع والحدود والرسوم. احتفظ بالمعايير التي تمت مراجعتها مع العملية. إذا تغيّر المسار أو الشروط الجوهرية، فجدّد المراجعة قبل الحصول على تفويض جديد.
في مبادلة EVM، ميّز بين الجهة المصرّح لها بإنفاق الرمز وعنوان تنفيذ المعاملة. توضح وثائق 0x اختلاف الدورين وتوجّه المطوّر إلى هدف السماح في استجابة API. تحقّق من الاستجابة وفق إعدادات المزوّد والشبكة المختارين قبل طلب الموافقة أو التوقيع من المحفظة.
احصر بيانات اعتماد المزوّد وسلطة المحفظة في العملية المطلوبة. تحتاج ميزة بيانات السوق للقراءة فقط إلى الصلاحيات اللازمة للقراءة. وفي واجهة تداول تعتمد على الحساب، تحقّق من صلاحيات الحساب ومعرّفات أوامر العميل المدعومة أثناء التخطيط.
عالج انتهاء مهلة الصفقة دون تكرارها
استخدم معرّف عملية ثابتًا لربط نية التداول المعتمدة بكل محاولة إرسال. قبل الإرسال، احفظ مرجع الطلب المتاح للمسار. إذا فُقدت الاستجابة، افحص الأمر أو المعاملة الأصلية قبل إنشاء محاولة أخرى قد تُنفّذ بشكل مستقل.
في منصة مركزية، احتفظ بمعرّف الأمر وكل تنفيذ جزئي ورسومه والكمية المتبقية. تُبلغ قناة executions الموثّقة لدى Kraken عن حالات أوامر الحساب وأحداث التنفيذ. طابق هذه السجلات باستخدام أدوات الاستعلام والاستعادة لدى المنصة عند غياب تحديث.
في سولانا، تُعيد sendTransaction توقيعًا عندما تقبل خدمة RPC المعاملة الموقّعة لإعادة توجيهها. لا تثبت هذه الاستجابة التأكيد. احفظ التوقيع ومعلومات الصلاحية وتحقّق من حالة التنفيذ واحسم المحاولة الأصلية قبل بناء بديلة.
في مثال اصطناعي، لنفترض أن operation-1042 ترسل مبادلة ثم تنتهي مهلة HTTP. أبقِ الشاشة في حالة انتظار التحقيق واستعلم بمرجع المعاملة الأصلية. إذا تأكدت، فطابق المبالغ الفعلية والرسوم. وإذا ظلت غير محسومة، فاحتفظ بالاستثناء. يحتاج عرض السعر الجديد إلى مراجعة خاصة وقرار بشأن المحاولة السابقة.
مصفوفة اختبارات إطلاق واجهة API للتداول
استخدم سجلات اصطناعية وبيئة الاختبار التي يدعمها المزوّد لفحوص التكامل. اتفق على طريقة التحقق من السلوك الذي لا تعيد بيئة الاختبار إنتاجه. أرفق تعليمات المشغّل بكل نتيجة غير محسومة.
| السيناريو | تمرير الأدلة |
|---|---|
| أداة مالية أو شبكة خاطئة | يرفض التحقق النية غير المطابقة قبل التوقيع |
| دفتر أوامر قديم أو تدفق بيانات منقطع | تُظهر الواجهة تقادم البيانات وتتبع إجراء إعادة المزامنة |
| تغيّر عرض السعر أو انتهاء صلاحيته | يراجع المستخدم الشروط الحالية قبل تفويض جديد |
| جهة إنفاق غير متوقعة للسماح | تُمنع موافقة المحفظة لحين التحقيق |
| فقدان استجابة الإرسال | تُحدَّد العملية الأصلية قبل محاولة تنفيذ أخرى |
| تنفيذ الأمر جزئيًا | تتطابق التنفيذات والرسوم والكمية المتبقية مع سجل المنصة |
| وصول التحديث نفسه مرتين | نتيجة معاملة أو تنفيذ مسجّل واحدة |
الأسئلة الشائعة
باختصار
- • اختر نطاق الواجهة بحسب إجراء المنتج.
- • وضّح الهوية والدقة وحداثة البيانات.
- • احسم العملية الأصلية قبل إعادة محاولة التنفيذ.
الحلول والمنتجات ذات الصلة
القراءة ذات الصلة
هل تحتاج إلى مساعدة في هذا القرار؟
خطّط لتكامل API لتداول العملات المشفرة يشمل بيانات السوق والتسعير والتنفيذ. يتضمن فحوص الاعتماد واستعادة الأوامر ومصفوفة اختبارات الإطلاق.