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.

CreateEmbedTokenResponse resp = client.createEmbedToken(
        CreateEmbedTokenRequest.of("agent-user-001", "tw_abc123")
                .withSymbol("ETHUSDT"));
System.out.println(resp.embedToken);
System.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

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

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.