Agent SDK

Créer un jeton d’intégration

Émettez des jetons d’intégration éphémères pour Trading Widget mode jeton partenaire.

Afficher en Markdown

SDK appelle

Créez des tokens d’intégration depuis votre backend après avoir validé la session utilisateur partenaire. Le navigateur doit appeler votre point de terminaison, et votre point de terminaison doit appeler 6MM via le 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);

Accréditation unique

embedToken est de courte durée et à usage unique. Ne le placez pas dans une chaîne de requête URL .

Exemple de terminaison 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}

Retournez uniquement les champs nécessaires au fournisseur Trading Widget token. Ne retournez pas apiSecret, champs de signature bruts ou configuration interne du service.

Gestion des pannes

ÉtatManipulation recommandée
La session utilisateur est manquante ou expiréeRetournez le 401 depuis le point de terminaison partenaire et demandez à l’utilisateur de se reconnecter.
L’utilisateur agent n’est pas liéAssignez d’abord l’utilisateur, puis réessayez la création du token.
6MM renvoie une erreur temporaireRetournez une erreur réessayable au frontend et enregistrez requestId pour le support.
channelId ne correspond pas à l’instance du widgetRejetez la requête et recréez la session du widget.