Χρήστες & Στοιχεία

Αυτός ο οδηγός στοχεύει Agent Java SDK v0.3.0, Java 8+ και τη δημόσια σύμβαση με ετικέτα. Τα παραδείγματα εκτελούνται σε ένα backend συνεργάτη μετά την προετοιμασία του client στο Γρήγορη εκκίνηση.

Παράδειγμα προαπαιτούμενα

Τα αποσπάσματα Java μοιράζονται αυτές τις εισαγωγές. Αρχικοποιήστε το client χρησιμοποιώντας Γρήγορη εκκίνηση και αποκτήστε platformUserId από την αποθηκευμένη δέσμευση. Παραδείγματα αναγνωριστικών χρήστη/παραγγελιών πρέπει να αντικατασταθούν με τις δικές σας σταθερές τιμές.

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

Κανόνες User ID

Το 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.

Πηγή και σχετικοί οδηγοί

• Επίσημη πηγή έκδοσης 0.3.0
• Επισκόπηση ερωτήματος και σελιδοποίηση
• Πορτοφόλι χρηματοδότησης
• Οδηγός αναβάθμισης