Référence et dépannage

Codes d’erreur et dépannage

Afficher en Markdown

Format de réponse à l’erreur

1{
2  "code": 1003,
3  "message": "Invalid token",
4  "requestId": "req-12345678"
5}

Les erreurs métier renvoient généralement toujours la structure JSON unifiée. Les intégrateurs devraient vérifier code d’abord. Les échecs d’authentification peuvent retourner HTTP 401; La limitation de taux peut revenir HTTP 429.

Codes d’erreur courants

Code d’erreurDescription
0Succès
1001Aucune information d’authentification valide fournie
1002Jeton expiré
1003Jeton, API Keyou signature invalides
1004Jeton révoqué
1006Source IP décalage
2001Paramètre requis manquant
2002Valeur de paramètre invalide
2003Paramètre hors plage
3001Équilibre insuffisant
3003Ordre non trouvé
3004Demande de doublons
3005La commande ne peut pas être annulée
3006Autorisation refusée
3100 - 3112Erreur de validation des paramètres d’ordre de condition
5001Erreur interne du serveur
5002Service temporairement indisponible
5003Limite de taux déclenchée

Dépannage

ProblèmeRecommandation
1001 aucune information d’authentification valideVérifiez si Authorization: Bearer <accessToken> ou X-API-KEY est inclus.
1002 Jeton expiréRafraîchissez le jeton ou reconnectez-vous avant de réessayer.
1003 Jeton, API Keyou signature invalidesVérifiez API Key, la charge utile de signature, le corps JSON chaîne de requête, et l’ordre des paramètres de requête.
1006 source IP décalageVérifiez la configuration API Key IP liste blanche.
3004 demande de doublonsNe réutilisez pas la même signature pour les chemins liés à l’ordre. Régénérer timestamp et signature.
5003 limite de taux déclenchéeRéduisez la fréquence des requêtes et utilisez un recul exponentiel si vous réessayez.
Timestamp outside of tolerance windowAppelez /v1/time pour calibrer le décalage temporel et signez à nouveau la demande.