Agent SDK

埋め込みトークンの作成

パートナートークンモード用の短命な埋め込みトークン 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 ウィジェットインスタンスと一致しませんリクエストを拒否してウィジェットセッションを再作成してください。