Codes d'Erreur

Cette page fournit des informations sur les codes d'erreur qui peuvent être retournés par l'API TronZap.

Format de Réponse d'Erreur

Quand une erreur se produit, l'API retournera une réponse avec un code d'erreur non-nul et un message d'erreur :

{
    "code": 1,
    "error": "Description du message d'erreur"
}

Liste des Codes d'Erreur

Code	Description	Résolution
0	Succès	Ce n'est pas une erreur. La requête a réussi.
1	Erreur d'authentification	Vérifiez votre token API et assurez-vous que votre signature est calculée correctement.
2	Service ou paramètres invalides	Vérifiez que le nom du service et les paramètres sont corrects.
5	Portefeuille non trouvé	Vérifiez l'adresse du portefeuille ou contactez le support si vous pensez qu'il s'agit d'une erreur.
6	Fonds insuffisants	Ajoutez des fonds à votre compte ou réduisez la quantité d'énergie que vous demandez.
10	Adresse TRON invalide	Vérifiez le format de l'adresse TRON. Elle doit être une adresse TRON valide de 34 caractères.
11	Quantité d'énergie invalide	Assurez-vous que la quantité d'énergie demandée est valide.
12	Durée invalide	Vérifiez que le paramètre de durée est valide.
20	Transaction non trouvée	Vérifiez que l'ID de transaction ou l'ID externe est correct.
24	Adresse non activée	Activez d'abord l'adresse en effectuant une transaction d'activation d'adresse.
25	Adresse déjà activée	L'adresse est déjà activée. Aucune action nécessaire.
500	Erreur interne du serveur	Contactez le support si cette erreur persiste.

Gestion des Erreurs

Lors de l'utilisation de l'API, vous devriez implémenter une logique de gestion d'erreur pour tous les codes d'erreur possibles. Voici quelques recommandations :

Erreurs d'Authentification (Code 1)

Les erreurs d'authentification indiquent des problèmes avec vos identifiants API ou le calcul de signature. Vous devriez :

• Vérifier que votre token API est correct
• Vérifier votre logique de calcul de signature
• Vous assurer que votre secret API n'est pas exposé dans le code côté client

Erreurs de Ressources (Codes 5, 6, 10, 20)

Les erreurs de ressources indiquent des problèmes avec les ressources fournies. Vous devriez :

• Valider les adresses TRON avant de les envoyer à l'API
• Vérifier le solde du compte avant d'effectuer des transactions
• Vérifier les ID de transaction lors de la vérification du statut

Erreurs de Logique Métier (Codes 24, 25)

Les erreurs de logique métier indiquent des problèmes avec l'opération demandée. Vous devriez :

• Implémenter une vérification d'activation d'adresse avant de tenter l'achat d'énergie
• Ignorer l'activation d'adresse si déjà activée