跳到导航
Agent Java SDK

創建嵌入令牌

創建嵌入令牌：Agent Java SDK v0.3.0 集成、示例、參數和響應語義。

以 Markdown 格式查看

本指南針對 Agent Java SDK v0.3.0、Java 8+ 以及標記的公共合約。初始化 client 後在合作伙伴後端運行示例 快速入門.

先決條件示例

Java 片段共享這些導入。使用快速啟動初始化 client 並從保存的綁定中獲取 platformUserId。示例用戶/訂單 ID 必須替換為您自己的持久值。

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

Trading Widget 嵌入令牌

嵌入令牌適用於 Trading Widget SDK partner-token + tokenProvider 模式。這 瀏覽器調用合作伙伴後端，合作伙伴後端調用此 Java SDK 創建一個 embedToken。

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);

集成要求：

  • channelId 必須使用 Trading Widget SDK 傳遞的值。
  • symbol 是可選的，可以攜帶當前的初始符號。這不是代幣交易對權限限制。
  • embedToken 是短暫且一次性的。不要將其放入 URL 查詢字符串中。
  • 合作伙伴前端絕不能持有 apiSecret。
  • expireAt 是以秒為單位的 Unix 時間戳，而不是 TTL。

合作伙伴後端端點示例：

@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());
}

合作伙伴端點合同

驗證合作伙伴會話並派生 agentUserId 服務器端。接受當前Widget channelId;返回頂級 embedToken、expireAt（Unix 秒）以及相同的 channelId。代理響應不提供 channelId：您的後端會回應它。在初始化和更新時獲取新的令牌；切勿重複使用它。代幣創建不轉移資金或選擇錢包環境。

看 秒交易 完整的前端/後端流程。

來源及相關指南