建立嵌入令牌

發行短命的嵌入代幣 Trading Widget 合作夥伴代幣模式。

以 Markdown 格式查看

SDK

驗證合作夥伴使用者會話後,從後端建立嵌入權杖。瀏覽器應該呼叫你的端點,端點也應該透過Agent SDK 呼叫6MM。

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

一次性憑證

embedToken 是短暫且一次性使用的。請勿將其置於 URL 查詢字串中。

後端端點範例

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}

僅回傳 Trading Widget 令牌提供者所需的欄位。不要回傳 apiSecret、原始簽名欄位或內部服務設定。

故障處理

狀況建議操作方法
使用者會話遺失或過期從合作夥伴端點回傳 401 並要求使用者重新登入。
代理使用者不受綁定先綁定使用者,再重新嘗試創建代幣。
6MM 會回傳一個暫時錯誤把可重試的錯誤回傳到前端,並記錄 requestId 尋求支援。
channelId 與 widget 實例不符拒絕請求並重新建立 widget session。
  • [Trading Widget 認證 (/sdk/trading-widget/authentication):將 tokenProvider 連接到合作夥伴端點。

  • [Java 快速啟動 ](/sdk/agent-sdk/java/quick-start): 安裝並初始化 AgentClient

  • 【秘密與簽名】(/sdk/security/secrets-signing):保護特工 API 秘密。

  • [Webhooks 與冪等性](/sdk/security/webhooks-idempotency):保護整合的回調端。
  • Trading Widget 認證

  • Java 快速入門

  • Agent SDK 祕密與 HMAC 手語

  • Webhook 簽名驗證與冪等性