Vai alla navigazione
Agent Java SDK

Agent Java SDK

Agent Java SDK: integrazione di Agent Java SDK v0.3.0, esempi, parametri e semantica della risposta.

Visualizza come Markdown

Questa guida è rivolta a Agent Java SDK v0.3.0, Java 8+ e agli appalti pubblici contrassegnati. Gli esempi vengono eseguiti nel backend di un partner dopo aver inizializzato client in Avvio rapido.

Base della documentazione: SDK v0.3.0, commit 54aa3c1. Seguono inoltre le Webhook regole di ricezione WEBHOOKS.md presso fa6c7b6; questo è un aggiornamento di sola documentazione, senza un nuovo artefatto SDK contenente metodi di supporto di avviso.

Versione e installazione

ArticoloValore
Tag sorgente stabilev0.3.0
JavaJava 8+
EspertoMaven 3.9+
Coordinatecom.sixmm.exchange.sdk:agent:0.3.0

GitHub ospita l’origine; non rende queste coordinate risolvibili da Maven Central. Utilizza l’installazione locale contrassegnata o il repository di artefatti approvato.

Cosa copre il SDK

CategoriaScenarioSDK APIDescrizione
Associazione dell’utenteAssocia l’utentebindCrea o recupera l’associazione tra un utente partner e un utente della piattaforma 6MM.
Query sulle risorseEffettua query sull’account del partnerqueryAccountInterrogare il margine del partner o il conto di finanziamento
Query sulle risorseInterrogare le risorse utentequeryUserAssetsQuery sulle risorse del contratto; utilizzare withFunding() per includere i saldi di finanziamento
TrasferimentiTrasferimento di importo fissotransferTrasferisci fondi da o verso 6MM
TrasferimentiTrasferisci tuttotransferAllOutRiporta tutto il saldo prelevabile dell’utente sulla piattaforma partner
TrasferimentiOrdine inversoreverseAnnulla un trasferimento riuscito quando il backend supporta un flusso di compensazione
TrasferimentiOrdine delle interrogazioniqueryOrderInterroga un ordine di trasferimento in base al numero dell’ordine del partner
TrasferimentiElenca gli ordinilistOrdersSfogliare gli ordini di trasferimento per la riconciliazione
WebhookVerifica della firmaWebhookVerifier.verifyVerificare gli organismi di allerta sugli eventi dei fondi grezzi e sulla liquidazione; il codice commerciante gestisce il tempo, la proprietà e i controlli di deduplicazione persistenti. Vedere Webhook Eventi e avvisi di liquidazione.
Portafoglio di finanziamentoTrasferimento fondiwalletTransferPartner ↔ Finanziamento o Finanziamento ↔ Contratto; confermare lo stato restituito
Portafoglio di finanziamentoStato del trasferimento dei fondiqueryWalletTransferRecupera un’operazione di finanziamento utilizzando il numero d’ordine del partner originale
Ingresso commercialeInserimento diretto URLcreateEntryUrlCrea un SSO URL una tantum per la modalità di reindirizzamento
Ingresso commercialeIncorpora tokencreateEmbedTokenCrea un token di breve durata per la modalità Trading Widget tokenProvider
Dati perpetuiOrdini perpetui attualilistCurrentPerpetualOrdersInterroga gli ordini attuali NORMAL o CONDITIONAL
Dati perpetuiStoria dell’ordine perpetuolistPerpetualOrderHistoryInterroga il terminale NORMAL o CONDITIONAL ordini
Dati perpetuiCommerci perpetuilistPerpetualTradesInterroga i riempimenti commerciali per un elenco esplicito di giocatori pubblici
Dati perpetuiPosizioni perpetue attualilistCurrentPerpetualPositionsInterroga le posizioni attuali
Dati perpetuiStorico delle posizioni perpetuolistPerpetualPositionHistoryInterroga le posizioni chiuse
Dati perpetuiRegistro dei conti perpetuilistPerpetualLedgerInterrogare i singoli record di modifica del saldo del contratto
Tassi di riferimento FiatElenca le valute legali supportatelistSupportedFiatCurrenciesElenca le valute fiat attualmente convertibili in USDT
Tassi di riferimento FiatRichiedi i tassi di riferimento FXqueryExchangeRatesInterroga i rapporti di riferimento giornalieri fiat-USDT per tutte le valute o per quelle selezionate
Informazioni sul servizioVersione del servizioversionInterrogare le informazioni sulla versione del servizio Agent

Configurazione

Ottenere i seguenti valori da 6MM prima integrando.

ArticoloEsempioDescrizione
baseUrlhttps://agent-api.6mm.comAgente API base URL, senza barra finale
agentCodeAGENT001Codice partner
apiSecretyour-api-secretAPI segreto di firma. Tienilo solo sul backend
defaultCurrencyUSDTValuta predefinita, solitamente USDT
webhookUrlhttps://partner.example.com/6mm/webhookRichiamata del commerciante URL condivisa da tutti e quattro i tipi di eventi; invio tramite organismo event, senza avviso separato URL.

Raccomandazioni per la produzione:

  • Utilizzare HTTPS per gli endpoint dell’agente API e webhook.
  • Archivia apiSecret in un gestore segreto, un centro di configurazione o una variabile di ambiente.
  • Mantieni l’ora del server sincronizzata, preferibilmente con NTP.
  • Conserva tutti i numeri d’ordine dei partner e mantienili univoci a livello globale.
  • Non inviare mai apiSecret a browser, app, mini programmi o codice sorgente frontend.

Campi per la firma automatica

Per le chiamate dell’agente API firmate, il SDK inserisce automaticamente:

CampoFonteDescrizione
agentCodeAgentClientConfig.agentCodeCodice partner
timestampAttuale UTC Timestamp UnixSecondi
nonceGeneratore casuale sicuroProtezione dalla riproduzione
signHMAC-SHA256Richiedi la firma
currencydefaultCurrencyCompilato quando le richieste di trasferimento/account omettono la valuta

Regole per la firma:

  1. Escludi sign.
  2. Escludi valori vuoti.
  3. Ordina le chiavi in ​​base all’ordine ASCII.
  4. Iscriviti come k=v&k2=v2.
  5. Calcola HMAC-SHA256 esadecimale con apiSecret.

I valori dell’array vengono serializzati come compatti JSON prima di unirsi al payload della firma. Ad esempio, platformUserIds viene indicato come ["1188041528"], fornendo platformUserIds=["1188041528"] nel payload k=v. Conserva l’ordine degli elementi dell’array, le virgolette doppie e gli ID delle stringhe; non inserire spazi di formattazione né utilizzare Java List.toString() (ad esempio [1188041528]). Il SDK gestisce questa serializzazione automaticamente.

Il normale codice aziendale non deve calcolare le firme o impostarle manualmente agentCode, timestamp, nonce o sign.

Fonte e guide correlate