Java البداية السريعة

التثبيت

يوثق المصدر العام SDK حاليا v0.1.1 العلامة مع إحداثيات مافن هذه:

1
<dependency>
2
    <groupId>com.sixmm.exchange.sdk</groupId>
3
    <artifactId>agent</artifactId>
4
    <version>0.1.1</version>
5
</dependency>

لا يعمل GitHub كمستودع اعتماد لمافن. قم بتثبيت المصدر الموسوم محليا قبل حل الاعتماد:

$
git clone https://github.com/6mm-com/agent-java-sdk.git
$
cd agent-java-sdk
$
git checkout v0.1.1
$
mvn install

بناء الفريق

انشر القطعة المعتمدة في مستودع Maven الخاص بمؤسستك لبناء CI والاختبار والإنتاج. تأكد من النسخة المعتمدة مع 6MM قبل نشر الإنتاج.

أمثلة على الشيفرة المصدرية والاستخدام متوفرة في المستودع الرسمي Java SDK :

[6mm-com/agent-java-sdk] (https://github.com/6mm-com/agent-java-sdk)

قبل أن تبدأ

• أكد URL API وكيل الإنتاج مع فريق 6MM.
• تخزين apiSecret في إدارة السرية الخلفية فقط.
• إعداد رسم خرائط مستقر بين platformUserId و agentUserId.
• تمكين سجلات منظمة حول تدفقات الربط، والنقل، والترتيب، والتدفقات عبر الويبهوك.

تهيئة العميل

1
import com.sixmm.agent.AgentClient;
2
import com.sixmm.agent.AgentClientConfig;
3
4
AgentClient client = new AgentClient(AgentClientConfig.builder()
5
        .baseUrl("https://agent-api.6mm.com")
6
        .agentCode("AGENT001")
7
        .apiSecret("your-api-secret")
8
        .defaultCurrency("USDT")
9
        .build());

الواجهة الخلفية فقط

لا تهيئة Agent SDK من كود العميل في المتصفح أو الهاتف المحمول أو سطح المكتب. يوقع SDK طلبات API الوكيل المميزة.

مثال: تحويل الأموال إلى

1
TransferResponse resp = client.transfer(TransferRequest.fixed(
2
        "AGT-ORDER-1001",
3
        "agent-user-001",
4
        Direction.IN,
5
        "USDT",
6
        "10.00"));

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

الخطوات التالية

• إنشاء رمز التضمين
• التحقق من توقيع Webhook & عدم تكرار المعالجة
• Agent SDK أسرار وتوقيع HMAC
• SDK استكشاف أخطاء التكامل