Códigos de Error

Esta página proporciona información sobre los códigos de error que pueden ser devueltos por la API de TronZap.

Formato de Respuesta de Error

Cuando ocurre un error, la API devolverá una respuesta con un código de error distinto de cero y un mensaje de error:

{
    "code": 1,
    "error": "Descripción del mensaje de error"
}

Lista de Códigos de Error

Código	Descripción	Resolución
0	Éxito	No es un error. La solicitud fue exitosa.
1	Error de autenticación	Verifique su token de API y asegúrese de que su firma esté calculada correctamente.
2	Servicio o parámetros inválidos	Verifique que el nombre del servicio y los parámetros sean correctos.
5	Billetera no encontrada	Verifique la dirección de la billetera o contacte con soporte si cree que esto es un error.
6	Fondos insuficientes	Agregue fondos a su cuenta o reduzca la cantidad de energía que está solicitando.
10	Dirección TRON inválida	Verifique el formato de la dirección TRON. Debe ser una dirección TRON válida de 34 caracteres.
11	Cantidad de energía inválida	Asegúrese de que la cantidad de energía solicitada sea válida.
12	Duración inválida	Verifique que el parámetro de duración sea válido.
20	Transacción no encontrada	Verifique que el ID de transacción o ID externo sea correcto.
24	Dirección no activada	Active primero la dirección realizando una transacción de activación de dirección.
25	Dirección ya activada	La dirección ya está activada. No se requiere acción.
500	Error interno del servidor	Contacte con soporte si este error persiste.

Manejo de Errores

Al consumir la API, debe implementar lógica de manejo de errores para todos los códigos de error posibles. Aquí hay algunas recomendaciones:

Errores de Autenticación (Código 1)

Los errores de autenticación indican problemas con sus credenciales de API o cálculo de firma. Debe:

• Verificar que su token de API sea correcto
• Revisar su lógica de cálculo de firma
• Asegurarse de que su secreto de API no esté expuesto en código del lado del cliente

Errores de Recursos (Códigos 5, 6, 10, 20)

Los errores de recursos indican problemas con los recursos proporcionados. Debe:

• Validar las direcciones TRON antes de enviarlas a la API
• Verificar el saldo de la cuenta antes de realizar transacciones
• Verificar los IDs de transacción al consultar el estado

Errores de Lógica de Negocio (Códigos 24, 25)

Los errores de lógica de negocio indican problemas con la operación solicitada. Debe:

• Implementar verificación de activación de dirección antes de intentar la compra de energía
• Omitir la activación de dirección si ya está activada