المستخدمون والأصول

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

مثال المتطلبات الأساسية

تشترك مقتطفات Java في هذه الواردات. قم بتهيئة client باستخدام البدء السريع واحصل على platformUserId من الرابط المحفوظ. يجب استبدال معرفات المستخدم/الطلب بالقيم الثابتة الخاصة بك.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

قواعد معرف المستخدم

platformUserId هو 6MM معرف المستخدم الخارجي. وهو حاليًا رقم رقمي مكون من 10 أرقام سلسلة، على سبيل المثال:

1188041528

قواعد:

• قم بتخزينها كسلسلة، وليس كعدد صحيح.
• ولا تولد منه أو تفك تشفيره أو تستنتج معنى منه.
• استخدم معرف المستخدم الخاص بك من جانب الشريك كـ agentUserId.
• استمر في العلاقة بين agentUserId وplatformUserId وagentOrderNo.

ربط المستخدم

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

import com.sixmm.agent.model.BindRequest;
import com.sixmm.agent.model.BindResponse;
BindResponse resp = client.bind(
        BindRequest.of("agent-user-001")
                .withUsername("alice")
                .withExt("{\"source\":\"web\"}"));
System.out.println(resp.platformUserId);
System.out.println(resp.bindStatus);
System.out.println(resp.isSimulatedUser);

حقول الطلب:

حقول الاستجابة:

الاستعلام عن حساب الشريك

import com.sixmm.agent.model.QueryAccountRequest;
import com.sixmm.agent.model.QueryAccountResponse;
QueryAccountResponse resp = client.queryAccount(QueryAccountRequest.of("USDT"));
System.out.println(resp.agentCode);
System.out.println(resp.agentStatus);
resp.assets.forEach(asset -> {
    System.out.println(asset.currency);
    System.out.println(asset.depositBalance);
});

عند غياب currency، يستخدم SDK defaultCurrency.

الاستعلام عن أصول المستخدم

import com.sixmm.agent.model.QueryUserAssetsRequest;
import com.sixmm.agent.model.QueryUserAssetsResponse;
QueryUserAssetsResponse resp = client.queryUserAssets(
        QueryUserAssetsRequest.of("1188041528"));
System.out.println(resp.walletBalance);
System.out.println(resp.availableBalance);
System.out.println(resp.version);

الحقول:

التمييز بين المحافظ الثلاث

queryAccount الاستعلام عن حساب هامش منصة التاجر، وليس محفظة مستخدم التاجر. لا تحتوي هذه الواجهة على معلمات environment ولا يمكن الاستعلام عنها كأصل مستخدم تمت محاكاته.

الاستعلام عن محفظتي النظام الأساسي للمستخدمين المحاكيين:

QueryUserAssetsResponse assets = client.queryUserAssets(
        QueryUserAssetsRequest.of(platformUserId)
                .withFunding()
                .withEnvironment(ExecutionEnvironment.SIMULATED));

الواجهة: POST /v1/agent/query-user-assets. يتم طلب التمويل فقط عندما includeFunding=true; يتم استخدام دلالات الاستعلام عن أصول العقد الأصلي بشكل افتراضي.

يتم التعامل مع المبالغ كسلاسل أو BigDecimal، وليس float/double.

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

• المصدر الرسمي v0.3.0
• نظرة عامة على الاستعلام وترقيم الصفحات
• محفظة التمويل
• دليل الترقية