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,
    "key": "auth",
    "request_id": "99d8b507-0bca-4d5a-9542-cc2a2f2e3639",
    "error": "Incorrect token or signature"
}

Liste des Codes d'Erreur

Code	Key	Description	Résolution
0	—	Succès	Ce n'est pas une erreur. La requête a réussi.
1	auth	Erreur d'authentification	Vérifiez votre token API et assurez-vous que votre signature est calculée correctement.
2	invalid_service_or_params	Service ou paramètres invalides	Vérifiez que le nom du service et les paramètres sont corrects.
5	wallet_not_found	Portefeuille non trouvé	Vérifiez l'adresse du portefeuille ou contactez le support si vous pensez qu'il s'agit d'une erreur.
6	insufficient_funds	Fonds insuffisants	Ajoutez des fonds à votre compte ou réduisez la quantité d'énergie que vous demandez.
10	invalid_tron_address	Adresse TRON invalide	Vérifiez le format de l'adresse TRON. Elle doit être une adresse TRON valide de 34 caractères.
11	invalid_energy_amount	Quantité d'énergie invalide	Assurez-vous que la quantité d'énergie demandée est valide.
12	invalid_duration	Durée invalide	Vérifiez que le paramètre de durée est valide.
50	invalid_bandwidth_amount	Quantité de bande passante invalide	Assurez-vous que la quantité de bande passante demandée est valide.
20	subscription_not_found	Abonnement introuvable	Vérifiez que l'identifiant d'abonnement ou l'identifiant externe est correct.
21	cannot_stop_subscription	Impossible d'arrêter l'abonnement	Vérifiez les limites de l'abonnement ; ajustez la limite de transactions ou finalisez les transactions en attente.
24	address_not_activated	Adresse non activée	Activez d'abord l'adresse en effectuant une transaction d'activation d'adresse.
25	address_already_activated	Adresse déjà activée	L'adresse est déjà activée. Aucune action nécessaire.
30	aml_check_not_found	Vérification AML introuvable	Relancez la vérification AML ou contactez le support pour confirmer le statut de vérification.
35	service_unavailable	Service non disponible	Le service est temporairement indisponible.
500	internal_server_error	Erreur interne du serveur	Contactez le support si cette erreur persiste.

Sous-clés (Sub-keys)

Certaines erreurs peuvent inclure une sous-clé plus spécifique qui fournit un contexte supplémentaire. Les sous-clés utilisent la notation pointée (par exemple, invalid_tron_address.from_address).

Clé de base	Sub-key	Description
invalid_tron_address	invalid_tron_address.from_address	Adresse d'expéditeur invalide
invalid_tron_address	invalid_tron_address.to_address	Adresse de destinataire invalide
invalid_tron_address	invalid_tron_address.contract_address	Adresse de contrat invalide
invalid_tron_address	invalid_tron_address.already_subscribed	L'adresse a déjà un abonnement actif
invalid_service_or_params	invalid_service_or_params.network	Réseau non supporté
invalid_service_or_params	invalid_service_or_params.address	Adresse fournie invalide
invalid_service_or_params	invalid_service_or_params.hash	Le hash est requis pour les vérifications de hash
invalid_service_or_params	invalid_service_or_params.direction	Direction manquante ou invalide (obligatoire pour les vérifications de hash)
invalid_service_or_params	invalid_service_or_params.page	Page invalide
invalid_service_or_params	invalid_service_or_params.per_page	per_page invalide
invalid_service_or_params	invalid_service_or_params.status	Statut invalide
invalid_service_or_params	invalid_service_or_params.id	id invalide / L'id ou l'external_id est requis
invalid_service_or_params	invalid_service_or_params.external_id	external_id invalide
invalid_service_or_params	invalid_service_or_params.address_owner	L'adresse appartient à un autre utilisateur
invalid_service_or_params	invalid_service_or_params.internal_credit	Crédit interne non autorisé
invalid_service_or_params	invalid_service_or_params.amount	Montant hors plage
invalid_service_or_params	invalid_service_or_params.exchange_finalized	Échange finalisé
invalid_service_or_params	invalid_service_or_params.exchange_state	Échange dans un état invalide
invalid_energy_amount	invalid_energy_amount.energy_amount	Quantité d'énergie invalide
invalid_energy_amount	invalid_energy_amount.bandwidth_amount	Quantité de bande passante invalide
invalid_duration	invalid_duration.duration	La durée doit être égale à 1 (1 heure)
address_not_activated	address_not_activated.subscription	L'adresse doit être activée avant l'achat d'un abonnement
subscription_not_found	subscription_not_found.transaction	Transaction introuvable

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