Comment corriger le « code de vérification expiré » lors de la connexion à OKX ?

Problèmes de synchronisation du temps

1. OKX exige que l'horodatage des requêtes API se situe à ± 30 secondes de l'heure du serveur. Une incompatibilité déclenche des erreurs « code de vérification expiré ».

2. Les développeurs doivent récupérer l'heure actuelle du serveur OKX via /api/v5/public/time et utiliser cette valeur au lieu de l'heure du système local.

3. Même si datetime.utcnow() semble synchronisé, une dérive au niveau de la microseconde ou une mauvaise configuration du fuseau horaire peut entraîner le rejet de la signature.

4. Certains environnements Python utilisent par défaut des objets datetime naïfs sans prise en compte du fuseau horaire UTC, ce qui entraîne des erreurs de conversion silencieuses lors du formatage de la chaîne.

5. Le format ISO 8601 doit se terminer par Z et les millisecondes doivent être tronquées à exactement trois chiffres (par exemple, 2026-05-28T11:24:36.123Z ).

Erreurs de génération de signature

1. La signature HMAC-SHA256 doit concaténer l'horodatage, la méthode HTTP en majuscules, le chemin de la requête et le corps dans un ordre strict.

2. Les corps JSON vides doivent être transmis sous forme de chaînes vides ( '' ), et non {} ou None , sinon le résumé du message devient invalide.

3. La clé secrète doit être utilisée comme premier argument dans hmac.new() ; inverser l'ordre de la clé et du message produit une signature incorrecte.

4. Le codage Base64 doit être appliqué directement aux octets bruts du résumé, et non aux versions codées en hexadécimal ou enveloppées de chaînes.

5. Tout espace final ou tout caractère Unicode invisible dans la clé secrète ou la phrase secrète invalidera silencieusement la signature.

Erreurs de configuration de la clé API

1. Les clés API avec autorisations de trading ou de retrait nécessitent une liaison IP ; les clés non liées sont automatiquement désactivées après 14 jours d'inactivité.

2. L'utilisation d'une clé API testnet sur le domaine de production (ou vice versa) entraîne un échec d'authentification immédiat sans code d'erreur explicite indiquant une incompatibilité d'environnement.

3. Les phrases secrètes sont sensibles à la casse et stockées sous forme de hachages irréversibles ; la saisie incorrecte d'un seul caractère génère une réponse 401 impossible à distinguer d'une clé API invalide.

4. Le codage en dur des informations d'identification dans les fichiers sources viole les meilleures pratiques de sécurité et peut exposer les clés lors d'incidents de débogage ou de contrôle de version.

5. Plusieurs tentatives de connexion simultanées utilisant la même clé API peuvent déclencher une limitation de débit sur le point de terminaison d'authentification, bloquant temporairement les requêtes valides.

Contraintes de réseau et de routage

1. Les requêtes acheminées via certains serveurs proxy ou pare-feu d'entreprise peuvent supprimer ou modifier l'en-tête OK-ACCESS-TIMESTAMP , provoquant une détection d'expiration côté serveur.

2. Les équilibreurs de charge ou CDN mettent parfois en cache les réponses des points de terminaison REST, même ceux nécessitant une authentification, ce qui entraîne la réutilisation d'horodatages obsolètes au fil des sessions.

3. Les configurations réseau IPv6 uniquement peuvent ne pas résoudre correctement les enregistrements DNS d'OKX si le repli à double pile est désactivé au niveau du système d'exploitation.

4. Les échecs de négociation TLS dus à des suites de chiffrement obsolètes ou à des incohérences d’épinglage de certificat empêchent les en-têtes d’atteindre entièrement la couche d’authentification.

5. Le routage basé sur la géolocalisation peut diriger les requêtes vers des points de terminaison régionaux (par exemple, myokx.com) qui appliquent des règles de validation plus strictes que le domaine mondial api.okx.com.

Foire aux questions

Q : Pourquoi OKX rejette-t-il mon code de vérification même si je l'ai saisi dans les 60 secondes ? R : Le rejet ne concerne pas le timing des entrées de l'utilisateur ; il reflète un échec de validation de signature côté serveur. L'étiquette « expiré » fait référence au paramètre d'horodatage dans la demande signée, et non à la durée de vie du code SMS.

Q : Puis-je réutiliser le même horodatage sur plusieurs requêtes ? R : Non. Chaque demande doit porter un horodatage unique, croissant de manière monotone. La réutilisation des valeurs déclenche la protection anti-relecture et renvoie le code d'erreur 10000 .

Q : L'activation de l'authentification à deux facteurs affecte-t-elle le flux de connexion à l'API ? R : Oui. L’inscription au TOTP ou à la clé matérielle désactive entièrement la vérification par SMS pour l’accès à l’API. Seules la clé API + la phrase secrète + la demande signée sont acceptées.

Q : Existe-t-il un moyen de vérifier la logique de ma signature sans soumettre de demandes en direct ? R : Oui. OKX fournit un point de terminaison de test public /api/v5/public/time qui accepte les requêtes GET non signées. Utilisez-le pour confirmer la connectivité de base et l'alignement temporel avant de signer des points de terminaison privés.