Comment créer une clé API WEEX : accès en lecture seule ou accès de trading

By: WEEX
|
0

Comment créer une clé API WEEX : accès en lecture seule ou accès de trading

Connectez-vous à WEEX sur le web et accédez à Compte → Gestion des API pour créer une clé API. Les nouvelles clés sont configurées par défaut en lecture seule. Si l’application doit effectuer des transactions, sélectionnez l’autorisation Spot ou Futures/Contrats correspondante.

Avant de créer la clé, déterminez quelle application l’utilisera. Un script de suivi des soldes et une stratégie de trading automatisée nécessitent des accès différents. Choisir les autorisations adaptées à cet usage précis facilite la gestion et le dépannage de l’intégration.

Quelle autorisation choisir ?

Ce que vous souhaitez fairePar où commencer
Consulter les tickers publics, les carnets d’ordres ou la configuration de la plateforme d’échangeLes points de terminaison publics ne nécessitent pas d’authentification du compte : vous pouvez donc commencer sans clé.
Consulter les soldes ou les informations privées sur les ordresCréez une clé en lecture seule et vérifiez les autorisations requises par le point de terminaison concerné.
Exécuter des transactions Spot via une applicationConfigurez l’autorisation Spot.
Exécuter des transactions sur contrats via une applicationConfigurez l’autorisation Futures/Contrats.

Une clé en lecture seule ne peut ni passer ni annuler des ordres. Vérifiez séparément les autorisations de trading Spot et sur contrats ; activer l’une ne signifie pas que l’autre est disponible. Le guide de préparation Spot et le guide de préparation Futures décrivent les accès concernés.

Créer la clé API

1. Ouvrez Gestion des API. Après vous être connecté, rendez-vous dans Gestion des API, ou sélectionnez Créer une API sur la page API de WEEX.
2. Saisissez les informations et choisissez les autorisations. Suivez les champs affichés. Conservez l’accès en lecture seule pour consulter les informations du compte, ou sélectionnez le marché approprié si vous devez effectuer des transactions.
3. Définissez la phrase secrète et associez une adresse IP. La phrase secrète de l’API est une phrase d’accès que vous choisissez pour cette clé. La FAQ officielle recommande d’utiliser des lettres et des chiffres, sans caractères spéciaux. Configurez l’association IP selon les exigences de la page.
4. Effectuez la vérification de sécurité et enregistrez les identifiants. Conservez en lieu sûr l’APIKey, le SecretKey et la Passphrase, puis vérifiez l’intégration à l’aide d’une requête en lecture seule autorisée.

L’ordre des champs peut changer : suivez donc les instructions affichées dans votre compte. Si vous connectez un outil tiers, vérifiez que les autorisations qu’il demande correspondent aux fonctions que vous comptez utiliser avant de saisir vos identifiants.

À quoi servent APIKey, SecretKey et Passphrase ?

APIKey identifie la requête API, SecretKey sert à générer sa signature et Passphrase est la phrase d’accès définie lors de la création de la clé. Chacun a un rôle différent. La phrase secrète de l’API est également distincte du mot de passe de connexion à votre compte.

Si un outil demande un « API Password », vérifiez la définition de ce champ. Par exemple, le champ password de CCXT correspond à la phrase secrète de l’API WEEX. Une valeur incorrecte peut empêcher l’authentification d’une requête privée, même si l’APIKey et le SecretKey sont corrects.

La documentation officielle indique qu’une phrase secrète perdue ne peut pas être récupérée : vous devez créer une nouvelle clé API. Lors de leur création, stockez les identifiants dans un environnement serveur contrôlé ou un gestionnaire de secrets, plutôt que de vous fier à des messages de discussion, des captures d’écran ou des constantes en texte brut dans le code.

Associez l’adresse IP réellement utilisée par votre application

Pour une application déployée sur un serveur, associez l’adresse IP publique sortante qu’elle utilise pour envoyer les requêtes. Un proxy, un NAT ou un service cloud peut modifier l’adresse externe : l’adresse IP privée du serveur peut donc différer de l’adresse source que WEEX détecte.

Vérifiez à nouveau l’association après un changement de serveur ou de réseau sortant. Les comptes standard doivent suivre les instructions de Gestion des API. Les API destinées aux utilisateurs finaux des courtiers sont soumises à des règles distinctes : leurs limites de saisie d’adresses IP ou leurs conditions obligatoires ne s’appliquent pas à tous les comptes.

Les deux guides de préparation indiquent que chaque utilisateur peut créer jusqu’à 10 groupes de clés API. Les séparer selon l’usage de chaque application — par exemple, un groupe pour le suivi du compte et un autre pour le trading — facilite le remplacement ou la désactivation ultérieure d’une intégration précise.

Pourquoi la clé peut-elle encore échouer après sa création ?

Partez du point où survient l’échec au lieu de créer à plusieurs reprises des clés de remplacement :

SymptômeVérification prioritaire
Les consultations du compte fonctionnent, mais les ordres échouentL’autorisation de trading pour le marché concerné. Une incompatibilité d’autorisation peut notamment provoquer l’erreur -1052.
Les requêtes privées échouent à l’authentificationLa phrase secrète de l’API, la signature, l’horodatage et l’adresse IP sortante réelle.
Une clé nouvellement créée ou modifiée est temporairement indisponibleLa FAQ actuelle indique un délai de propagation habituel d’environ 15 minutes, et non une échéance garantie.
La restriction « API Restricted » persisteContactez le support officiel au sujet des restrictions du compte, au lieu d’envoyer à plusieurs reprises des requêtes invalides.

Pour obtenir de l’aide, utilisez les liens d’assistance de la FAQ API officielle et indiquez l’heure, le point de terminaison et le code d’erreur. Masquez les identifiants, les signatures et les données sensibles du compte dans les journaux.

Si vous pensez qu’une clé a été exposée, arrêtez l’intégration concernée, supprimez la clé exposée, examinez l’historique du compte et des ordres, puis créez une clé de remplacement avec les autorisations nécessaires.

Articles connexes
Partager
copy

À la hausse

iconiconiconiconiconiconiconicon
Assistance client:@weikecs
Collaborations commerciales:@weikecs
Trading quantitatif/Market makers:bd@weex.com
Programme VIP:support@weex.com