Códigos de Error

Cuando una llamada a la API falla, la respuesta contiene un code distinto de cero y un mensaje error legible por humanos.

Formato de respuesta de error

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

Campo	Descripción
code	Código de error entero distinto de cero.
key	Nombre del campo que causó el error, cuando aplica. Cadena vacía en caso contrario.
request_id	Identificador único de la solicitud. Inclúyelo al contactar con soporte.
error	Descripción legible por humanos del error.

Códigos de estado HTTP

Estado HTTP	Significado
200	Solicitud exitosa (code: 0) o error a nivel de aplicación (code: non-zero).
429	Límite de velocidad superado — 1 solicitud/segundo/IP en los endpoints /v1/orders*.
422	Solicitud no procesable — validación fallida (también devuelto como code: non-zero en el cuerpo).
500	Error interno del servidor — fallo inesperado en nuestro lado.

Casos de error comunes

Situación	Causa probable
address_from o address_to inválido	No es una dirección TRON válida (debe comenzar con T, 34 caracteres).
duration distinto de 1	Solo se admiten alquileres de 1 hora.
Tanto energy como bandwidth son 0	Se debe solicitar al menos un recurso.
energy o bandwidth fuera de rango	La cantidad solicitada está por debajo del mínimo o por encima del máximo para este proyecto.
Orden activa duplicada	Ya existe una orden activa para el mismo par address_from + address_to en estado new.
order_id no encontrado	El order_id pasado a check o cancel no existe.
Límite de velocidad superado	Estás enviando más de 1 solicitud/segundo desde la misma IP. Reduce la frecuencia y vuelve a intentarlo.
referral_code demasiado largo	La cadena referral_code supera los 64 caracteres.

Manejo de errores

1. Siempre verifica code en el cuerpo de la respuesta — HTTP 200 no garantiza el éxito.
2. Registra request_id junto a cualquier error para depuración.
3. Para HTTP 429, implementa retroceso exponencial antes de reintentar.
4. Para duplicate active order, usa Consultar Orden para recuperar la orden existente en lugar de crear una nueva.