Agent SDK

Criar Embed Token

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

Ver como Markdown

SDK chamada

Crie tokens de embed a partir do seu backend após validar a sessão do usuário parceiro. O navegador deve chamar seu endpoint, e seu endpoint deve chamar 6MM pelo 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 coloque isso em uma URL string de consulta.

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 pelo fornecedor de tokens Trading Widget . Não retorne apiSecret, campos de assinatura bruta ou configuração interna do serviço.

Manuseio de falhas

CondiçãoManuseio recomendado
A sessão do usuário está ausente ou expiradaDevolva o 401 do endpoint parceiro e peça para o usuário fazer login novamente.
O usuário agente não está vinculadoAtribua primeiro o usuário, depois tente novamente a criação do token.
6MM retorna um erro temporárioDevolva um erro retentável para o frontend e registre requestId para suporte.
channelId não corresponde à instância do widgetRejeite o pedido e recrie a sessão do widget.