Zur Navigation springen
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK v0.3.0 Integration, Beispiele, Parameter und Antwortsemantik.

Als Markdown anzeigen

Dieser Leitfaden richtet sich an Agent Java SDK v0.3.0, Java 8+ und den getaggten öffentlichen Auftrag. Beispiele werden nach der Initialisierung von client in einem Partner-Backend ausgeführt Schnellstart.

Dokumentationsbasis: SDK v0.3.0, Commit 54aa3c1. Webhook Es gelten zusätzlich Empfangsregeln WEBHOOKS.md um fa6c7b6; Dies ist ein reines Dokumentationsupdate ohne ein neues SDK-Artefakt mit Hilfsmethoden für Warnungen.

Version und Installation

ArtikelWert
Stabiles Quell-Tagv0.3.0
JavaJava 8+
MavenMaven 3.9+
Koordinatencom.sixmm.exchange.sdk:agent:0.3.0

GitHub-Hosts-Quelle; Dadurch sind diese Koordinaten nicht von Maven Central aus auflösbar. Verwenden Sie die markierte lokale Installation oder Ihr genehmigtes Artefakt-Repository.

Was der SDK abdeckt

KategorieSzenarioSDK APIBeschreibung
BenutzerbindungBenutzer bindenbindErstellen oder rufen Sie die Bindung zwischen einem Partnerbenutzer und einem 6MM-Plattformbenutzer ab
Asset-AbfragenPartnerkonto abfragenqueryAccountFragen Sie die Partnermarge oder das Finanzierungskonto ab
Asset-AbfragenBenutzerressourcen abfragenqueryUserAssetsVertragsvermögenswerte abfragen; Verwenden Sie withFunding(), um Finanzierungssalden einzubeziehen
ÜberweisungenFestbetragsüberweisungtransferGeld in oder aus 6MM überweisen
ÜberweisungenÜbertragen Sie alles raustransferAllOutVerschieben Sie das gesamte auszahlbare Benutzerguthaben zurück auf die Partnerplattform
ÜberweisungenUmgekehrte ReihenfolgereverseStornieren Sie eine erfolgreiche Übertragung, wenn das Backend einen Kompensationsfluss unterstützt
ÜberweisungenReihenfolge abfragenqueryOrderFragen Sie einen Übertragungsauftrag nach Partnerauftragsnummer ab
ÜberweisungenBestellungen auflistenlistOrdersDurchblättern Sie Übertragungsaufträge zum Abgleich
WebhookSignaturüberprüfungWebhookVerifier.verifyÜberprüfen Sie die Gremien für Rohgeldereignisse und Liquidationswarnungen. Der Händlercode übernimmt Zeit-, Eigentums- und dauerhafte Deduplizierungsprüfungen. Sehen Webhook Ereignisse und Liquidationswarnungen.
Funding-WalletFördermitteltransferwalletTransferPartner ↔ Finanzierung oder Finanzierung ↔ Vertrag; Bestätigen Sie den zurückgegebenen Status
Funding-WalletStatus der FinanzierungsübertragungqueryWalletTransferStellen Sie einen Finanzierungsvorgang unter Verwendung seiner ursprünglichen Partnerbestellnummer wieder her
HandelseintragDirekteintrag URLcreateEntryUrlErstellen Sie einen einmaligen SSO URL für den Weiterleitungsmodus
HandelseintragToken einbettencreateEmbedTokenErstellen Sie ein kurzlebiges Token für den Modus Trading Widget tokenProvider.
Perpetuelle DatenAktuelle DaueraufträgelistCurrentPerpetualOrdersFragen Sie aktuelle NORMAL- oder CONDITIONAL-Bestellungen ab
Perpetuelle DatenEwige BestellhistorielistPerpetualOrderHistoryFragen Sie die Bestellungen des Terminals NORMAL oder CONDITIONAL ab
Perpetuelle DatenDauergeschäftelistPerpetualTradesFragen Sie Handelsfüllungen nach einer expliziten öffentlichen Spielerliste ab
Perpetuelle DatenAktuelle unbefristete StellenlistCurrentPerpetualPositionsAktuelle Positionen abfragen
Perpetuelle DatenEwige PositionshistorielistPerpetualPositionHistoryGeschlossene Positionen abfragen
Perpetuelle DatenUnbefristetes KontobuchlistPerpetualLedgerAbfragen einzelner Vertragssaldo-Änderungsdatensätze
Fiat-ReferenzkurseListen Sie die unterstützten Fiat-Währungen auflistSupportedFiatCurrenciesFiat-Währungen auflisten, die derzeit in USDT konvertierbar sind
Fiat-ReferenzkurseFX-Referenzkurse abfragenqueryExchangeRatesFragen Sie tägliche Fiat-zu-USDT-Referenzverhältnisse für alle oder ausgewählte Währungen ab
ServiceinformationenServiceversionversionInformationen zur Version des Abfrage-Agent-Dienstes

Konfiguration

Besorgen Sie sich zuvor die folgenden Werte von 6MM. integrierend.

ArtikelBeispielBeschreibung
baseUrlhttps://agent-api.6mm.comAgent API Basis URL, ohne abschließenden Schrägstrich
agentCodeAGENT001Partnercode
apiSecretyour-api-secretAPI Signaturgeheimnis. Behalten Sie es nur im Backend
defaultCurrencyUSDTStandardwährung, normalerweise USDT
webhookUrlhttps://partner.example.com/6mm/webhookHändlerrückruf URL, der von allen vier Ereignistypen gemeinsam genutzt wird; Versand durch Körper event, ohne gesonderte Warnung URL.

Produktionsempfehlungen:

  • Verwenden Sie HTTPS für die Endpunkte Agent API und webhook.
  • Speichern Sie apiSecret in einem Secret Manager, einem Konfigurationscenter oder einer Umgebungsvariablen.
  • Halten Sie die Serverzeit synchronisiert, vorzugsweise mit NTP.
  • Behalten Sie alle Partner-Bestellnummern bei und sorgen Sie dafür, dass sie global eindeutig sind.
  • Senden Sie niemals apiSecret an Browser, Apps, Miniprogramme oder Frontend-Quellcode.

Automatische Signaturfelder

Bei signierten Agenten-Anrufen API fügt SDK automatisch Folgendes ein:

FeldQuelleBeschreibung
agentCodeAgentClientConfig.agentCodePartnercode
timestampAktueller UTC Unix-ZeitstempelSekunden
nonceSicherer ZufallsgeneratorWiedergabeschutz
signHMAC-SHA256Unterschrift anfordern
currencydefaultCurrencyWird ausgefüllt, wenn bei Überweisungs-/Kontoanfragen die Währung fehlt

Signaturregeln:

  1. sign ausschließen.
  2. Leere Werte ausschließen.
  3. Sortieren Sie die Schlüssel nach der Reihenfolge ASCII.
  4. Treten Sie bei als k=v&k2=v2.
  5. Berechnen Sie HMAC-SHA256 hex mit apiSecret.

Array-Werte werden als kompakte JSON serialisiert, bevor sie der Signierungsnutzlast hinzugefügt werden. Beispielsweise signiert platformUserIds als ["1188041528"] und ergibt platformUserIds=["1188041528"] in der Nutzlast k=v. Behalten Sie die Reihenfolge der Array-Elemente, doppelte Anführungszeichen und String-IDs bei. Fügen Sie keine Formatierungsleerzeichen ein und verwenden Sie nicht Java List.toString() (z. B. [1188041528]). Der SDK übernimmt diese Serialisierung automatisch.

Der normale Geschäftscode sollte keine Signaturen berechnen oder manuell festlegen agentCode, timestamp, nonce oder sign.

Quelle und zugehörige Leitfäden