Skip to navigation
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK التكامل v0.3.0 والأمثلة والمعلمات ودلالات الاستجابة.

View as Markdown

يستهدف هذا الدليل Agent Java SDK v0.3.0، Java 8+، والعقد العام الموسوم. يتم تشغيل الأمثلة في الواجهة الخلفية للشريك بعد تهيئة client في بداية سريعة.

خط الأساس للتوثيق: SDK v0.3.0، الالتزام 54aa3c1. Webhook تتبع أيضًا قواعد الاستلام WEBHOOKS.md في fa6c7b6; هذا تحديث للتوثيق فقط، بدون قطعة أثرية جديدة SDK تحتوي على أساليب مساعدة للتحذير.

الإصدار والتثبيت

غرضقيمة
علامة مصدر مستقرةv0.3.0
JavaJava 8+
مخضرممخضرم 3.9+
الإحداثياتcom.sixmm.exchange.sdk:agent:0.3.0

يستضيف GitHub المصدر؛ لا يجعل هذه الإحداثيات قابلة للحل من Maven Central. استخدم التثبيت المحلي الموسوم أو مستودع القطع الأثرية المعتمد لديك.

ما يغطيه SDK

فئةسيناريوSDK APIوصف
ملزمة المستخدمربط المستخدمbindقم بإنشاء أو جلب الارتباط بين مستخدم شريك ومستخدم النظام الأساسي 6MM
استعلامات الأصولالاستعلام عن حساب الشريكqueryAccountالاستعلام عن هامش الشريك أو حساب التمويل
استعلامات الأصولالاستعلام عن أصول المستخدمqueryUserAssetsالاستعلام عن أصول العقد؛ استخدم withFunding() لتضمين أرصدة التمويل
التحويلاتتحويل مبلغ ثابتtransferتحويل الأموال إلى أو من 6MM
التحويلاتنقل كل شيءtransferAllOutقم بنقل كافة أرصدة المستخدم القابلة للسحب مرة أخرى إلى النظام الأساسي الشريك
التحويلاتترتيب عكسيreverseقم بعكس النقل الناجح عندما تدعم الواجهة الخلفية تدفق التعويض
التحويلاتترتيب الاستعلامqueryOrderالاستعلام عن أمر تحويل واحد عن طريق رقم أمر الشريك
التحويلاتقائمة الطلباتlistOrdersصفحة من خلال أوامر النقل للمصالحة
Webhookالتحقق من التوقيعWebhookVerifier.verifyالتحقق من الأموال الأولية الخاصة بالحدث وهيئات التحذير من التصفية؛ يتعامل رمز التاجر مع الوقت والملكية وعمليات التحقق المستمرة من إلغاء البيانات المكررة. يرى Webhook الأحداث وتحذيرات التصفية.
محفظة التمويلتحويل التمويلwalletTransferالشريك ↔ التمويل أو التمويل ↔ العقد؛ تأكيد الحالة التي تم إرجاعها
محفظة التمويلحالة تحويل التمويلqueryWalletTransferاسترداد عملية التمويل باستخدام رقم طلب الشريك الأصلي الخاص بها
دخول التداولالدخول المباشر URLcreateEntryUrlقم بإنشاء SSO URL مرة واحدة لوضع إعادة التوجيه
دخول التداولتضمين الرمز المميزcreateEmbedTokenقم بإنشاء رمز مميز قصير العمر لوضع Trading Widget tokenProvider
بيانات دائمةالأوامر الدائمة الحاليةlistCurrentPerpetualOrdersالاستعلام عن الطلبات الحالية NORMAL أو CONDITIONAL
بيانات دائمةتاريخ النظام الدائمlistPerpetualOrderHistoryالاستعلام عن أوامر NORMAL أو CONDITIONAL
بيانات دائمةالصفقات الدائمةlistPerpetualTradesالاستعلام عن تعبئة قائمة اللاعبين العامة الصريحة
بيانات دائمةالمواقف الدائمة الحاليةlistCurrentPerpetualPositionsالاستعلام عن المناصب الحالية
بيانات دائمةتاريخ الموقف الدائمlistPerpetualPositionHistoryالاستعلام عن المراكز المغلقة
بيانات دائمةدفتر الحسابات الدائمlistPerpetualLedgerالاستعلام عن سجلات تغيير رصيد العقد الفردي
الأسعار المرجعية لشركة فياتقائمة العملات الورقية المدعومةlistSupportedFiatCurrenciesقائمة العملات الورقية القابلة للتحويل حاليًا إلى USDT
الأسعار المرجعية لشركة فياتالاستعلام عن الأسعار المرجعية للعملات الأجنبيةqueryExchangeRatesالاستعلام اليومي عن النسب المرجعية للعملات الورقية إلى USDT لجميع العملات أو العملات المحددة
معلومات الخدمةنسخة الخدمةversionمعلومات إصدار خدمة وكيل الاستعلام

إعدادات

احصل على القيم التالية من 6MM من قبل دمج.

غرضمثالوصف
baseUrlhttps://agent-api.6mm.comالوكيل API قاعدة URL، بدون شرطة مائلة زائدة
agentCodeAGENT001رمز الشريك
apiSecretyour-api-secretAPI سر التوقيع. احتفظ بها على الواجهة الخلفية فقط
defaultCurrencyUSDTالعملة الافتراضية، عادة USDT
webhookUrlhttps://partner.example.com/6mm/webhookرد اتصال التاجر URL مشترك بين جميع أنواع الأحداث الأربعة؛ إرسال بواسطة الجسم event، بدون تحذير منفصل URL.

توصيات الإنتاج:

  • استخدم HTTPS لنقاط النهاية للعامل API وwebhook.
  • قم بتخزين apiSecret في مدير سري أو مركز تكوين أو متغير بيئة.
  • حافظ على مزامنة وقت الخادم، ويفضل أن يكون ذلك مع NTP.
  • الحفاظ على جميع أرقام طلبات الشركاء والاحتفاظ بها فريدة عالميًا.
  • لا ترسل أبدًا apiSecret إلى المتصفحات أو التطبيقات أو البرامج الصغيرة أو كود مصدر الواجهة الأمامية.

حقول التوقيع التلقائي

بالنسبة لمكالمات الوكيل الموقعة API، يقوم SDK بإدخال ما يلي تلقائيًا:

مجالمصدروصف
agentCodeAgentClientConfig.agentCodeرمز الشريك
timestampالطابع الزمني الحالي UTC لنظام التشغيل Unixثواني
nonceتأمين مولد عشوائيإعادة الحماية
signHMAC-SHA256طلب التوقيع
currencydefaultCurrencyيتم ملؤها عند حذف طلبات التحويل/الحساب العملة

قواعد التوقيع:

  1. استبعاد sign.
  2. استبعاد القيم الفارغة.
  3. فرز المفاتيح حسب ترتيب ASCII.
  4. انضم باسم k=v&k2=v2.
  5. احسب الست عشري HMAC-SHA256 باستخدام apiSecret.

يتم تسلسل قيم المصفوفة على أنها مضغوطة JSON قبل الانضمام إلى حمولة التوقيع. على سبيل المثال، يشير platformUserIds إلى ["1188041528"]، مما يؤدي إلى ظهور platformUserIds=["1188041528"] في الحمولة النافعة k=v. الحفاظ على ترتيب عناصر المصفوفة وعلامات الاقتباس المزدوجة ومعرفات السلسلة؛ لا تقم بإدخال مسافات التنسيق أو استخدام Java List.toString() (مثل [1188041528]). يعالج SDK هذا التسلسل تلقائيًا.

لا يجب أن يقوم رمز العمل العادي بحساب التوقيعات أو تعيينها يدويًا agentCode، timestamp، nonce، أو sign.

المصدر والأدلة ذات الصلة