Agent SDK

Create Embed Token

Geben Sie kurzlebige Embed-Tokens für Trading Widget Partner-Token-Modus aus.

Als Markdown anzeigen

SDK Ruf

Erstellen Sie nach der Validierung der Partnerbenutzersitzung Embed-Token aus Ihrem Backend. Der Browser sollte Ihren Endpunkt aufrufen, und Ihr Endpunkt sollte 6MM über die Agent SDK aufrufen.

1CreateEmbedTokenResponse resp = client.createEmbedToken(
2        CreateEmbedTokenRequest.of("agent-user-001", "tw_abc123")
3                .withSymbol("ETHUSDT"));
4
5System.out.println(resp.embedToken);
6System.out.println(resp.expireAt);

Einmaliges Zertifikat

embedToken ist nur von kurzer Dauer und einmaliger Gebrauch. Platzieren Sie es nicht in eine URL Abfrage-Zeichenkette.

Beispiel für einen Backend-Endpunkt

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

Geben Sie nur die vom Trading Widget Token-Anbieter benötigten Felder zurück. Geben Sie keine apiSecret, Rohsignaturfelder oder interne Service-Konfigurationen zurück.

Fehlerhandhabung

ZustandEmpfohlenes Handling
Die Benutzersitzung fehlt oder ist abgelaufenGeben Sie 401 vom Partnerendpunkt zurück und bitten Sie den Benutzer, sich erneut anzumelden.
Der Agent-Nutzer ist nicht gebundenBinde zuerst den Benutzer und versuche dann erneut die Token-Erstellung.
6MM gibt einen temporären Fehler zurückGib einen wiederholbaren Fehler an das Frontend zurück und logge requestId zur Unterstützung.
channelId passt nicht zur Widget-InstanzLehne die Anfrage ab und erstelle die Widget-Sitzung erneut.