Zur Navigation springen

Einbettungstoken erstellen

Einbettungstoken erstellen: 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.

Beispielvoraussetzungen

Die Java-Snippets teilen diese Importe. Initialisieren Sie client mit Quick Start und rufen Sie platformUserId aus der gespeicherten Bindung ab. Beispiel-Benutzer-/Bestell-IDs müssen durch Ihre eigenen persistenten Werte ersetzt werden.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

Trading Widget Token einbetten

Das Einbettungstoken gilt für den Modus Trading Widget SDK partner-token + tokenProvider. Der Der Browser ruft das Partner-Backend auf, und das Partner-Backend ruft Folgendes auf: Java SDK um ein embedToken zu erstellen.

import com.sixmm.agent.model.CreateEmbedTokenRequest;
import com.sixmm.agent.model.CreateEmbedTokenResponse;
CreateEmbedTokenResponse resp = client.createEmbedToken(
CreateEmbedTokenRequest.of("agent-user-001", "tw_abc123")
.withSymbol("ETHUSDT"));
System.out.println(resp.embedToken);
System.out.println(resp.expireAt);

Integrationsvoraussetzungen:

  • channelId muss den von Trading Widget SDK übergebenen Wert verwenden.
  • symbol ist optional und kann das aktuelle Anfangssymbol tragen. Es handelt sich nicht um eine Berechtigungsbeschränkung für Token-Handelspaare.
  • embedToken ist kurzlebig und einmalig. Fügen Sie es nicht in URL-Abfragezeichenfolgen ein.
  • Das Partner-Frontend darf niemals apiSecret enthalten.
  • expireAt ist ein Unix-Zeitstempel in Sekunden, kein TTL.

Beispiel für einen Partner-Backend-Endpunkt:

@PostMapping("/api/trading/embed-token")
public EmbedTokenView createEmbedToken(@RequestBody EmbedTokenRequest request,
PartnerSession session) {
String agentUserId = session.getAgentUserId();
CreateEmbedTokenResponse resp = agentClient.createEmbedToken(
CreateEmbedTokenRequest.of(agentUserId, request.getChannelId())
.withSymbol(request.getSymbol()));
return new EmbedTokenView(resp.embedToken, resp.expireAt, request.getChannelId());
}

Partnerendpunktvertrag

Authentifizieren Sie die Partnersitzung und leiten Sie agentUserId serverseitig ab. Akzeptieren Sie das aktuelle Widget channelId; Rückgabe der obersten Ebene embedToken, expireAt (Unix-Sekunden) und dasselbe channelId. Agentenantworten liefern nicht channelId: Ihr Backend gibt es zurück. Rufen Sie bei der Initialisierung und Erneuerung ein neues Token ab. Verwenden Sie es niemals wieder. Bei der Token-Erstellung werden weder Gelder übertragen noch die Wallet-Umgebung ausgewählt.

Sehen Sekundenhandel für den kompletten Frontend-/Backend-Flow.

Quelle und zugehörige Leitfäden