Przejdź do nawigacji
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK integracja v0.3.0, przykłady, parametry i semantyka odpowiedzi.

Zobacz jako Markdown

Ten przewodnik jest przeznaczony dla Agent Java SDK v0.3.0, Java 8+ i oznaczonych zamówień publicznych. Przykłady działają w zapleczu partnera po inicjalizacji client w Szybki start.

Bazowa dokumentacja: SDK v0.3.0, zatwierdzenie 54aa3c1. Webhook dodatkowo przestrzegane są zasady odbierania WEBHOOKS.md w fa6c7b6; jest to aktualizacja zawierająca wyłącznie dokumentację, bez nowego SDK artefaktu zawierającego metody pomocnicze ostrzegające.

Wersja i instalacja

PrzedmiotWartość
Stabilny znacznik źródłowyv0.3.0
JavaJava 8+
MavenaMavena 3.9+
Współrzędnecom.sixmm.exchange.sdk:agent:0.3.0

Źródło hostów GitHub; nie sprawia to, że te współrzędne są rozpoznawalne z Maven Central. Użyj oznaczonej instalacji lokalnej lub zatwierdzonego repozytorium artefaktów.

Co obejmuje SDK

KategoriaScenariuszSDK APIOpis
Wiązanie użytkownikaPowiąż użytkownikabindUtwórz lub pobierz powiązanie między użytkownikiem partnera a użytkownikiem platformy 6MM
Zapytania dotyczące zasobówZapytanie o konto partneraqueryAccountZapytaj o marżę partnera lub konto finansowania
Zapytania dotyczące zasobówZapytaj o zasoby użytkownikaqueryUserAssetsZapytanie o zasoby kontraktu; użyj withFunding(), aby uwzględnić salda finansowania
TransferyPrzelew o stałej kwocietransferPrzelej środki do lub z 6MM
TransferyPrzenieś całośćtransferAllOutPrzenieś całe saldo użytkowników, które można wypłacić, z powrotem na platformę partnerską
TransferyOdwrotna kolejnośćreverseOdwróć pomyślny transfer, gdy zaplecze obsługuje przepływ kompensacji
TransferyKolejność zapytaniaqueryOrderZapytaj o jedno zlecenie przeniesienia według numeru zamówienia partnera
TransferyLista zamówieńlistOrdersPrzejrzyj zamówienia przeniesienia w celu uzgodnienia
WebhookWeryfikacja podpisuWebhookVerifier.verifyWeryfikacja organów surowcowych w przypadku zdarzeń i likwidacji; kod sprzedawcy obsługuje kontrolę czasu, własności i trwałej deduplikacji. Widzieć Webhook Ostrzeżenia dotyczące zdarzeń i likwidacji.
Portfel finansowaniaTransfer środkówwalletTransferPartner ↔ Finansowanie lub Finansowanie ↔ Umowa; potwierdź zwrócony status
Portfel finansowaniaStan transferu środkówqueryWalletTransferOdzyskaj operację finansowania, korzystając z oryginalnego numeru zamówienia partnera
Wejście handloweWpis bezpośredni URLcreateEntryUrlUtwórz jednorazowe SSO URL dla trybu przekierowania
Wejście handloweOsadź tokencreateEmbedTokenUtwórz krótkotrwały token dla trybu Trading Widget tokenProvider
Nieustanne daneAktualne zlecenia wieczystelistCurrentPerpetualOrdersZapytanie o aktualne zamówienia NORMAL lub CONDITIONAL
Nieustanne daneStała historia zamówieńlistPerpetualOrderHistoryZapytaj terminal NORMAL lub CONDITIONAL o zamówienia
Nieustanne daneNieustanne transakcjelistPerpetualTradesZapytanie o wypełnienie transakcji dla jawnej publicznej listy graczy
Nieustanne daneAktualne pozycje wieczystelistCurrentPerpetualPositionsZapytanie o aktualne pozycje
Nieustanne daneStała historia pozycjilistPerpetualPositionHistoryZapytanie o zamknięte pozycje
Nieustanne daneKsięga wieczysta kontalistPerpetualLedgerZapytaj o zapisy dotyczące zmian salda poszczególnych kontraktów
Stawki referencyjne FiataLista obsługiwanych walut fiducjarnychlistSupportedFiatCurrenciesLista walut fiducjarnych aktualnie wymienialnych na USDT
Stawki referencyjne FiataZapytanie o kursy referencyjne walutqueryExchangeRatesZapytaj codziennie o współczynniki referencyjne fiat do USDT dla wszystkich lub wybranych walut
Informacje serwisoweWersja serwisowaversionZapytanie o informacje o wersji usługi agenta

Konfiguracja

Uzyskaj następujące wartości z 6MM wcześniej integrowanie.

PrzedmiotPrzykładOpis
baseUrlhttps://agent-api.6mm.comAgent API podstawa URL, bez końcowego ukośnika
agentCodeAGENT001Kod partnera
apiSecretyour-api-secretAPI tajemnica podpisywania. Trzymaj go tylko na zapleczu
defaultCurrencyUSDTDomyślna waluta, zwykle USDT
webhookUrlhttps://partner.example.com/6mm/webhookWywołanie zwrotne sprzedawcy URL wspólne dla wszystkich czterech typów zdarzeń; wysyłka przez organ event, bez osobnego ostrzeżenia URL.

Zalecenia produkcyjne:

  • Użyj HTTPS dla punktów końcowych agenta API i webhook.
  • Przechowuj apiSecret w tajnym menedżerze, centrum konfiguracji lub zmiennej środowiskowej.
  • Synchronizuj czas serwera, najlepiej z NTP.
  • Zachowaj wszystkie numery zamówień partnerów i zachowaj je globalnie unikalne.
  • Nigdy nie wysyłaj apiSecret do przeglądarek, aplikacji, miniprogramów lub kodu źródłowego frontendu.

Automatyczne pola podpisywania

W przypadku wywołań podpisanego agenta API, SDK automatycznie dodaje:

PoleŹródłoOpis
agentCodeAgentClientConfig.agentCodeKod partnera
timestampBieżący UTC znacznik czasu UniksaTowary drugiej jakości
nonceBezpieczny generator losowyOchrona przed powtórkami
signHMAC-SHA256Poproś o podpis
currencydefaultCurrencyWypełniane, gdy żądania przelewu/konta pomijają walutę

Zasady podpisywania:

  1. Wyklucz sign.
  2. Wyklucz puste wartości.
  3. Sortuj klucze według kolejności ASCII.
  4. Dołącz jako k=v&k2=v2.
  5. Oblicz HMAC-SHA256 szesnastkowo za pomocą apiSecret.

Wartości tablicy są serializowane jako kompaktowe JSON przed dołączeniem do ładunku podpisującego. Na przykład platformUserIds znakuje jako ["1188041528"], podając platformUserIds=["1188041528"] w ładunku k=v. Zachowaj kolejność elementów tablicy, podwójne cudzysłowy i identyfikatory ciągów; nie wstawiaj spacji formatujących ani nie używaj Java List.toString() (np. [1188041528]). SDK automatycznie obsługuje tę serializację.

Normalny kod biznesowy nie powinien obliczać podpisów ani ustawiać go ręcznie agentCode, timestamp, nonce lub sign.

Źródło i powiązane przewodniki