Costruire un'integrazione

6MM Agent SDK

Visualizza come Markdown

Il 6MM Agent SDK riguarda i servizi backend partner che devono chiamare un Agent API privilegiato senza implementare la gestione della firma e delle richieste da zero. Non deve funzionare in codice browser, mobile o desktop pubblico perché l’integrazione utilizza un partner API segreto.

Quando usare il Agent SDK

Usa l’Agent SDK quando il backend deve associare un utente partner, trasferire asset tramite un flusso approvato, consultare i registri di trading, creare un URL di accesso al trading integrato o verificare le notifiche Webhook. Usa separatamente il Trading Widget SDK quando il frontend del partner deve mostrare l’interfaccia di trading.

Capacità

ScenarioJava SDKPHP SDK
Associare l’utenteSupportatiSupportati
Trasferimento a importo fissoSupportatiSupportati
Trasferisci tutto fuoriSupportatiSupportati
Trasferimento inversoSupportatiSupportati
Ordini di querySupportatiSupportati
Crea URLSupportatiSupportati
Verifica WebhookSupportatiSupportati

Configurazione comune

ChiaveEsempioDescrizione
baseUrlhttps://agent-api.6mm.com6MM Agent API servizio URL senza slash di seguimento.
agentCodeAGENT001Codice agente partner.
apiSecretyour-api-secretAPI segreto di firma memorizzato solo nel backend.
defaultCurrencyUSDTValuta predefinita per trasferimenti e API conto.
webhookUrlhttps://partner.example.com/6mm/webhookPartner endpoint per notifiche 6MM webhook.

Flusso tipico di integrazione

  1. Il frontend del partner autentica l’utente tramite il sistema account del partner.
  2. Il backend partner mappa l’utente a un identificatore stabile lato partner.
  3. Il backend chiama il Agent SDK con agentCode e il API protetto segreto.
  4. Il SDK firma e invia l’Agente API richiesta.
  5. Il backend memorizza l’identificativo di business restituito e processa ipotentemente i webhook successivi.
  6. Il frontend riceve solo il risultato di breve durata o la credenziali di ingresso necessaria.

Scegli un SDK

Elenco di controllo della produzione

  • Carica apiSecret da un gestore di segreti backend, non dal codice sorgente.
  • Mantenere separati le credenziali di sviluppo, staging e produzione.
  • Utilizzare una mappatura utente partner stabile e identificatori unici.
  • Preservare l’identificatore originale quando si verifica lo stato di una richiesta con timeout.
  • Verifica le firme dei webhook e memorizza gli ID degli eventi processati.
  • Oscurare segreti e firme dai log mantenendo gli ID delle richieste per il supporto.

Passi successivi

Java Avvio rapido

Installa e inizializza il Agent SDK in un backend Java .

PHP Avvio rapido

Installa e inizializza il Agent SDK in un backend PHP .

Webhook e idempotenza

Verifica i callback e evita l’elaborazione duplicata del business.