Agent SDK

Crear Token de Incrustación

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

Ver como Markdown

SDK llamada

Crea tokens de embed 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 Trading Widget token. No devuelvas apiSecret, campos de firma en bruto ni configuración interna del servicio.

Manejo de fallas

CondiciónManejo recomendado
La sesión de usuario falta o expiróDevuelve el 401 desde el endpoint del socio y pide al usuario que inicie sesión de nuevo.
El usuario agente no está vinculadoAsigna primero al usuario, 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 solicitud y recrea la sesión del widget.