Passer à la navigation
Agent Java SDK

Entrée directe URL

Entrée directe URL : intégration Agent Java SDK v0.3.0, exemples, paramètres et sémantique de réponse.

Afficher en Markdown

Ce guide cible Agent Java SDK v0.3.0, Java 8+ et le contrat public étiqueté. Exemples exécutés dans un backend partenaire après l’initialisation de client dans Démarrage rapide.

Exemples de prérequis

Les extraits de code Java partagent ces importations. Initialisez client à l’aide de Quick Start et obtenez platformUserId à partir de la liaison enregistrée. Les exemples d’ID utilisateur/commande doivent être remplacés par vos propres valeurs persistantes.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

Entrée directe URL

L’entrée directe URL est destinée au mode de redirection. Un utilisateur partenaire clique sur un bouton du site partenaire, ouvre l’interface 6MM et est automatiquement connecté.

import com.sixmm.agent.model.CreateEntryUrlRequest;
import com.sixmm.agent.model.CreateEntryUrlResponse;
CreateEntryUrlResponse resp = client.createEntryUrl(
        CreateEntryUrlRequest.of("agent-user-001")
                .withRedirectPath("/en/futures/BTCUSDT?tradingMode=real")
                .withReturnUrl("https://partner.example.com/return#markets"));
System.out.println(resp.webUrl);
System.out.println(resp.expireAt);

Règles de terrain :

ChampDescription
redirectPath6MM chemin relatif du frontend. Il doit commencer par /, par exemple /en/futures/BTCUSDT?tradingMode=real
returnUrlPartenaire absolu URL utilisé lorsque l’utilisateur quitte l’interface 6MM. Seuls http et https sont autorisés
expireAtDélai d’expiration du ticket d’entrée sous forme d’horodatage Unix en secondes

L’exemple ouvre des futurs perpétuels en mode réel. Pour le trading simulé, utilisez tradingMode=demo dans le frontend et transmettez explicitement environment=SIMULATED dans les requêtes de portefeuille backend correspondantes. Les fonds frontend tradingMode et backend environment sont configurés séparément. La création d’une entrée URL authentifie l’utilisateur ; il ne transfère pas de fonds et ne sélectionne pas d’environnement de portefeuille.

Exigences de sécurité :

  • webUrl contient un ticket unique. Utilisez-le immédiatement et ne le stockez pas à long terme.
  • Si l’entrée URL expire ou a été utilisée, générez-en une nouvelle depuis le site partenaire.
  • returnUrl ne doit pas être javascript:, un chemin relatif ou un URL avec les informations utilisateur.

Sélection du produit et du mode

Utilisez la route frontale actuelle fournie par 6MM. Par exemple /zh-CN/up-down?tradingMode=demo, /zh-CN/high-low?tradingMode=real, /zh-CN/grid-prediction?tradingMode=real ou /zh-CN/futures/BTCUSDT?tradingMode=real. Le ticket authentifie l’utilisateur ; il ne sélectionne pas un environnement de financement ni ne déplace de fonds.

Voir Trading de secondes pour les exemples de redirection et intégrés.

Source et guides associés