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

Lista de Códigos de Error

Código	Key	Descripción	Resolución
0	—	Éxito	No es un error. La solicitud fue exitosa.
1	auth	Error de autenticación	Verifique su token de API y asegúrese de que su firma esté calculada correctamente.
2	invalid_service_or_params	Servicio o parámetros inválidos	Verifique que el nombre del servicio y los parámetros sean correctos.
5	wallet_not_found	Billetera no encontrada	Verifique la dirección de la billetera o contacte con soporte si cree que esto es un error.
6	insufficient_funds	Fondos insuficientes	Agregue fondos a su cuenta o reduzca la cantidad de energía que está solicitando.
10	invalid_tron_address	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	invalid_energy_amount	Cantidad de energía inválida	Asegúrese de que la cantidad de energía solicitada sea válida.
12	invalid_duration	Duración inválida	Verifique que el parámetro de duración sea válido.
50	invalid_bandwidth_amount	Cantidad de bandwidth inválida	Asegúrese de que la cantidad de bandwidth solicitada sea válida.
20	subscription_not_found	Suscripción no encontrada	Verifique que el ID de la suscripción o el ID externo sea correcto.
21	cannot_stop_subscription	No se puede detener la suscripción	Revise los límites de la suscripción; ajuste el límite de transacciones o complete las transacciones pendientes.
24	address_not_activated	Dirección no activada	Active primero la dirección realizando una transacción de activación de dirección.
25	address_already_activated	Dirección ya activada	La dirección ya está activada. No se requiere acción.
30	aml_check_not_found	Verificación AML no encontrada	Repita la verificación AML o contacte al soporte para confirmar el estado de verificación.
35	service_unavailable	Servicio no disponible	El servicio está temporalmente no disponible.
500	internal_server_error	Error interno del servidor	Contacte con soporte si este error persiste.

Sub-claves (Sub-keys)

Algunos errores pueden incluir una sub-clave más específica que proporciona contexto adicional. Las sub-claves usan notación de punto (por ejemplo, invalid_tron_address.from_address).

Clave Base	Sub-key	Descripción
invalid_tron_address	invalid_tron_address.from_address	Dirección de origen inválida
invalid_tron_address	invalid_tron_address.to_address	Dirección de destino inválida
invalid_tron_address	invalid_tron_address.contract_address	Dirección de contrato inválida
invalid_tron_address	invalid_tron_address.already_subscribed	La dirección ya tiene una suscripción activa
invalid_service_or_params	invalid_service_or_params.network	Red no compatible
invalid_service_or_params	invalid_service_or_params.address	Dirección proporcionada inválida
invalid_service_or_params	invalid_service_or_params.hash	Se requiere hash para las verificaciones de hash
invalid_service_or_params	invalid_service_or_params.direction	Dirección ausente o inválida (obligatoria para las verificaciones de hash)
invalid_service_or_params	invalid_service_or_params.page	Página inválida
invalid_service_or_params	invalid_service_or_params.per_page	per_page inválido
invalid_service_or_params	invalid_service_or_params.status	Estado inválido
invalid_service_or_params	invalid_service_or_params.id	id inválido / Se requiere id o external_id
invalid_service_or_params	invalid_service_or_params.external_id	external_id inválido
invalid_service_or_params	invalid_service_or_params.address_owner	La dirección pertenece a otro usuario
invalid_service_or_params	invalid_service_or_params.internal_credit	Crédito interno no permitido
invalid_service_or_params	invalid_service_or_params.amount	Monto fuera de rango
invalid_service_or_params	invalid_service_or_params.exchange_finalized	Intercambio finalizado
invalid_service_or_params	invalid_service_or_params.exchange_state	Intercambio en estado inválido
invalid_energy_amount	invalid_energy_amount.energy_amount	Cantidad de energía inválida
invalid_energy_amount	invalid_energy_amount.bandwidth_amount	Cantidad de ancho de banda inválida
invalid_duration	invalid_duration.duration	La duración debe ser igual a 1 (1 hora)
address_not_activated	address_not_activated.subscription	La dirección debe activarse antes de comprar una suscripción
subscription_not_found	subscription_not_found.transaction	Transacción no encontrada

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