Agent SDK

Crear Token de Embed

Emitir tokens embed de corta duración para Trading Widget modo partner-token.

Ver como Markdown

SDK llamada

Crea tokens embebidos desde tu backend después de validar la sesión de usuario del socio. El navegador debería llamar a tu endpoint, y tu endpoint debería llamar a 6MM a través del 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 es de corta duración y de uso único. No lo pongas en una cadena de consulta URL .

Ejemplo 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}

Devuelva solo los campos necesarios para el proveedor de tokens Trading Widget . No devuelvas apiSecret, campos de firma en bruto ni configuración interna del servicio.

Manejo de fallos

EstadoManipulación recomendada
La sesión de usuario falta o está expiradaDevuelve el 401 desde el endpoint del socio y pide al usuario que inicie sesión de nuevo.
El usuario agente no está vinculadoVincula primero al usuario y luego vuelve a intentar crear el token.
6MM devuelve un error temporalDevuelve un error reintentable al frontend y registra requestId para soporte.
channelId no coincide con la instancia del widgetRechaza la petición y recrea la sesión del widget.