Μετάβαση στην πλοήγηση
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK Ενσωμάτωση v0.3.0, παραδείγματα, παράμετροι και σημασιολογία απόκρισης.

Προβολή ως Markdown

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

Βασική γραμμή τεκμηρίωσης: SDK v0.3.0, δέσμευση 54aa3c1. Ακολουθούν επιπλέον Webhook κανόνες λήψης WEBHOOKS.md στο fa6c7b6; Αυτή είναι μια ενημέρωση μόνο για τεκμηρίωση, χωρίς νέο SDK τεχνούργημα που περιέχει βοηθητικές μεθόδους προειδοποίησης.

Έκδοση και εγκατάσταση

ΕίδοςΑξία
Σταθερή ετικέτα πηγήςv0.3.0
JavaJava 8+
MavenMaven 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Αντιστρέψτε μια επιτυχημένη μεταφορά όταν το backend υποστηρίζει μια ροή αντιστάθμισης
ΜεταγραφέςΣειρά ερωτήματος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Ερώτηση μεμονωμένων αρχείων υπολοίπου συμβολαίου-αλλαγής
Τιμές αναφοράς FiatΚατάλογος υποστηριζόμενων νομισμάτων fiatlistSupportedFiatCurrenciesΚαταχωρίστε τα νομίσματα fiat που είναι επί του παρόντος μετατρέψιμα σε USDT
Τιμές αναφοράς FiatΖητήστε τιμές αναφοράς FXqueryExchangeRatesΖητήστε ημερήσιες αναλογίες αναφοράς fiat-to-USDT για όλα ή επιλεγμένα νομίσματα
Πληροφορίες σέρβιςΈκδοση υπηρεσίαςversionΠληροφορίες έκδοσης υπηρεσίας Query Agent

Διαμόρφωση

Λάβετε τις ακόλουθες τιμές από το 6MM πριν ενσωμάτωση.

ΕίδοςΠαράδειγμαΠεριγραφή
baseUrlhttps://agent-api.6mm.comΠράκτορας API βάση URL, χωρίς τελική κάθετο
agentCodeAGENT001Κωδικός συνεργάτη
apiSecretyour-api-secretAPI μυστικό υπογραφής. Διατηρήστε το μόνο στο backend
defaultCurrencyUSDTΠροεπιλεγμένο νόμισμα, συνήθως USDT
webhookUrlhttps://partner.example.com/6mm/webhookΕπιστροφή κλήσης εμπόρου URL κοινόχρηστο και από τους τέσσερις τύπους συμβάντων. αποστολή από το σώμα event, χωρίς ξεχωριστή προειδοποίηση URL.

Συστάσεις παραγωγής:

  • Χρησιμοποιήστε το HTTPS για τα τελικά σημεία Agent 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.

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