Codes d'Erreur

Lorsqu'un appel API échoue, la réponse contient un code non nul et un message error lisible par l'humain.

Format de la réponse d'erreur

{
  "code": 60,
  "key": "address_from",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "error": "Invalid TRON address"
}

Champ	Description
code	Code d'erreur entier non nul.
key	Nom du champ ayant causé l'erreur, le cas échéant. Chaîne vide sinon.
request_id	Identifiant unique de la requête. À inclure lors de la prise de contact avec le support.
error	Description lisible par l'humain de l'erreur.

Codes de statut HTTP

Statut HTTP	Signification
200	Requête réussie (code: 0) ou erreur au niveau applicatif (code: non-zero).
429	Limite de débit dépassée — 1 requête/seconde/IP sur les endpoints /v1/orders*.
422	Requête non traitable — validation échouée (également retourné comme code: non-zero dans le corps).
500	Erreur interne du serveur — défaillance inattendue de notre côté.

Cas d'erreur courants

Situation	Cause probable
address_from ou address_to invalide	Adresse TRON non valide (doit commencer par T, 34 caractères).
duration différent de 1	Seules les locations d'1 heure sont prises en charge.
energy et bandwidth tous deux à 0	Au moins une ressource doit être demandée.
energy ou bandwidth hors limites	Le montant demandé est inférieur au minimum ou supérieur au maximum pour ce projet.
Commande active en double	Une commande active pour la même paire address_from + address_to existe déjà en statut new.
order_id introuvable	L'order_id passé à check ou cancel n'existe pas.
Limite de débit dépassée	Vous envoyez plus d'1 requête/seconde depuis la même IP. Attendez avant de réessayer.
referral_code trop long	La chaîne referral_code dépasse 64 caractères.

Gestion des erreurs

1. Vérifiez toujours code dans le corps de la réponse — HTTP 200 ne garantit pas le succès.
2. Enregistrez request_id avec chaque erreur pour le débogage.
3. Pour HTTP 429, implémentez un recul exponentiel avant de réessayer.
4. Pour duplicate active order, utilisez Vérifier une Commande pour récupérer la commande existante au lieu d'en créer une nouvelle.