Agent SDK

Criar Token de Incorporação

Emitir tokens de embed de curta duração para Trading Widget modo partner-token.

Ver como Markdown

SDK chamada

Cria tokens de embed a partir do teu backend depois de validares a sessão do utilizador parceiro. O navegador deve ligar para o seu endpoint, e o seu endpoint deve chamar- 6MM através do Agent SDK.

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

Credencial única

embedToken é de curta duração e de uso único. Não o coloque numa cadeia de consulta URL .

Exemplo de endpoint backend

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}

Devolva apenas os campos necessários ao fornecedor de tokens Trading Widget . Não devolva apiSecret, campos de assinatura bruta ou configuração interna do serviço.

Gestão de falhas

CondiçãoManuseamento recomendado
A sessão do utilizador está em falta ou expiradaDevolva o 401 do endpoint parceiro e peça ao utilizador para iniciar sessão novamente.
O utilizador agente não está vinculadoAssocie primeiro o utilizador, depois tente novamente a criação do token.
6MM devolve um erro temporárioDevolva um erro retentável para o frontend e loge requestId para suporte.
channelId não corresponde à instância do widgetRejeita o pedido e recria a sessão do widget.