Códigos de Erro

Esta página fornece informações sobre os códigos de erro que podem ser retornados pela API TronZap.

Formato da Resposta de Erro

Quando ocorre um erro, a API retornará uma resposta com um código de erro diferente de zero e uma mensagem de erro:

{
    "code": 1,
    "key": "auth",
    "request_id": "99d8b507-0bca-4d5a-9542-cc2a2f2e3639",
    "error": "Incorrect token or signature"
}

Lista de Códigos de Erro

Código	Key	Descrição	Resolução
0	—	Sucesso	Não é um erro. A requisição foi bem-sucedida.
1	auth	Erro de autenticação	Verifique seu token de API e certifique-se de que sua assinatura está calculada corretamente.
2	invalid_service_or_params	Serviço ou parâmetros inválidos	Verifique se o nome do serviço e os parâmetros estão corretos.
5	wallet_not_found	Carteira não encontrada	Verifique o endereço da carteira ou entre em contato com o suporte se acreditar que isso é um erro.
6	insufficient_funds	Saldo insuficiente	Adicione fundos à sua conta ou reduza a quantidade de energia que você está solicitando.
10	invalid_tron_address	Endereço TRON inválido	Verifique o formato do endereço TRON. Deve ser um endereço TRON válido de 34 caracteres.
11	invalid_energy_amount	Quantidade de energia inválida	Certifique-se de que a quantidade de energia solicitada é válida.
12	invalid_duration	Duração inválida	Verifique se o parâmetro de duração é válido.
50	invalid_bandwidth_amount	Quantidade de bandwidth inválida	Certifique-se de que a quantidade de bandwidth solicitada é válida.
20	subscription_not_found	Assinatura não encontrada	Verifique se o ID da assinatura ou o ID externo está correto.
21	cannot_stop_subscription	Não é possível interromper a assinatura	Revise os limites da assinatura; ajuste o limite de transações ou conclua as transações pendentes.
24	address_not_activated	Endereço não ativado	Ative o endereço primeiro fazendo uma transação de ativação de endereço.
25	address_already_activated	Endereço já ativado	O endereço já está ativado. Nenhuma ação necessária.
30	aml_check_not_found	Verificação AML não encontrada	Refaça a verificação AML ou entre em contato com o suporte para confirmar o status da verificação.
35	service_unavailable	Serviço indisponível	O serviço está temporariamente indisponível.
500	internal_server_error	Erro interno do servidor	Entre em contato com o suporte se este erro persistir.

Sub-chaves (Sub-keys)

Alguns erros podem incluir uma sub-chave mais específica que fornece contexto adicional. As sub-chaves usam notação de ponto (por exemplo, invalid_tron_address.from_address).

Chave Base	Sub-key	Descrição
invalid_tron_address	invalid_tron_address.from_address	Endereço de origem inválido
invalid_tron_address	invalid_tron_address.to_address	Endereço de destino inválido
invalid_tron_address	invalid_tron_address.contract_address	Endereço de contrato inválido
invalid_tron_address	invalid_tron_address.already_subscribed	O endereço já possui uma assinatura ativa
invalid_service_or_params	invalid_service_or_params.network	Rede não suportada
invalid_service_or_params	invalid_service_or_params.address	Endereço fornecido inválido
invalid_service_or_params	invalid_service_or_params.hash	Hash é necessário para verificações de hash
invalid_service_or_params	invalid_service_or_params.direction	Direção ausente ou inválida (obrigatória para verificações 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	Status inválido
invalid_service_or_params	invalid_service_or_params.id	id inválido / É necessário id ou 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	O endereço pertence a outro usuário
invalid_service_or_params	invalid_service_or_params.internal_credit	Crédito interno não permitido
invalid_service_or_params	invalid_service_or_params.amount	Valor fora do intervalo
invalid_service_or_params	invalid_service_or_params.exchange_finalized	Troca finalizada
invalid_service_or_params	invalid_service_or_params.exchange_state	Troca em estado inválido
invalid_energy_amount	invalid_energy_amount.energy_amount	Quantidade de energia inválida
invalid_energy_amount	invalid_energy_amount.bandwidth_amount	Quantidade de largura de banda inválida
invalid_duration	invalid_duration.duration	A duração deve ser igual a 1 (1 hora)
address_not_activated	address_not_activated.subscription	O endereço deve ser ativado antes de comprar uma assinatura
subscription_not_found	subscription_not_found.transaction	Transação não encontrada

Tratamento de Erros

Ao consumir a API, você deve implementar lógica de tratamento de erros para todos os códigos de erro possíveis. Aqui estão algumas recomendações:

Erros de Autenticação (Código 1)

Erros de autenticação indicam problemas com suas credenciais de API ou cálculo de assinatura. Você deve:

• Verificar se seu token de API está correto
• Verificar sua lógica de cálculo de assinatura
• Garantir que seu segredo de API não esteja exposto no código do lado do cliente

Erros de Recurso (Códigos 5, 6, 10, 20)

Erros de recurso indicam problemas com os recursos fornecidos. Você deve:

• Validar endereços TRON antes de enviá-los para a API
• Verificar o saldo da conta antes de fazer transações
• Verificar IDs de transação ao verificar o status

Erros de Lógica de Negócio (Códigos 24, 25)

Erros de lógica de negócio indicam problemas com a operação solicitada. Você deve:

• Implementar verificação de ativação de endereço antes de tentar comprar energia
• Pular a ativação de endereço se já estiver ativado