Passer à la navigation
Agent Java SDK

Mise à niveau vers la version 0.3.0

Mise à niveau vers la v0.3.0 : 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 et Java 8+.

Décidez de ce qui doit être mis à niveau

Intégration existanteAction
Fonctions de production existantes avec environnement omisLes formes de réponse existantes restent compatibles ; les nouvelles requêtes ne forcent pas une mise à niveau.
Authentification intégrée générique existante pour le trading de secondesRéutiliser l’authentification et le renouvellement ; sélectionnez la page produit souhaitée.
Soldes de financement, transferts et recouvrementUtilisez les modèles contenant withFunding, walletTransfer et queryWalletTransfer.
Fonds simulés explicitesUtilisez des modèles de requête/réponse prenant en charge environment.
Six requêtes de données perpétuellesUtilisez public Java SDK v0.3.0, y compris les six méthodes et la prise en charge de la signature de tableau.

Conservez vos baseUrl, agentCode, apiSecret actuels, vos liaisons utilisateur et vos commandes commerciales originales.

Installer la balise publique stable

GitHub héberge la source. La publication d’une balise GitHub ne publie pas les coordonnées Maven sur Maven Central. Installez la source balisée localement ou publiez son JAR/POM vérifié dans le référentiel d’artefacts de votre organisation.

git clone --branch v0.3.0 --single-branch https://github.com/6mm-com/agent-java-sdk.git agent-java-sdk-v0.3.0
cd agent-java-sdk-v0.3.0
git rev-parse HEAD
git rev-parse 'v0.3.0^{commit}'
mvn install

Les deux ID de validation doivent correspondre. Déclarez la dépendance dans le projet partenaire :

<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.3.0</version>
</dependency>

Vérifiez la dépendance résolue :

mvn dependency:tree -Dincludes=com.sixmm.exchange.sdk:agent

Une installation locale rend l’artefact disponible uniquement sur cette machine. CI et les autres développeurs ont besoin de la même installation balisée ou de votre référentiel d’artefacts vérifié. Si vous disposez déjà d’un artefact privé nommé 0.3.0, vérifiez sa source et ses méthodes ; n’écrasez pas silencieusement un artefact partagé.

Modifications d’intégration requises

  1. Mettre à jour les modèles de requête et de réponse pour les environment. Les anciens modèles de réponse stricts peuvent rejeter le champ supplémentaire.
  2. Utilisez withFunding() avant de lire funding. Les soldes de contrats ne sont pas des soldes de négociation secondaire.
  3. Utilisez /v1/agent/wallet-transfer et /v1/agent/wallet-transfer-status pour le financement. L’ancien queryOrder ne peut pas récupérer une opération de financement.
  4. Les six requêtes utilisent platformUserIds comme tableau de chaînes. Signer les tableaux comme étant compacts JSON ; Java List.toString() n’est pas compatible.
  5. Stockez les ordres de transfert, les ordres de négociation ordinaires, les ordres conditionnels et les exécutions en tant qu’entités distinctes. Analyser orderStatus ou status selon l’opération.
  6. Vérifiez le corps webhook d’origine avant l’analyse. Les notifications simulées explicites incluent environment ; comparez-le avec la commande enregistrée.
  7. Gérez les versions Java et Widget indépendamment. Une mise à niveau du backend ne modifie pas la page frontend ou le mode de trading, et le trading des secondes ne nécessite pas un nouveau type de jeton.

Vérifier la mise à niveau

Exécutez la build du projet partenaire et inspectez son arborescence de dépendances. Liaison de test, flux de production d’origine, soldes simulés explicites, récupération des résultats de financement, les six requêtes, pagination à fenêtre fixe, gestion des erreurs et rappels idempotents.

Pour un client HTTP personnalisé, suivez la demande balisée et le contrat de signature au lieu de supposer que les anciens modèles couvrent de nouveaux champs. Voir Règles de signature des agents, Présentation de la requête et Guide environnement.

Source et guides associés