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,
    "error": "Descrição da mensagem de erro"
}

Lista de Códigos de Erro

Código	Descrição	Resolução
0	Sucesso	Não é um erro. A requisição foi bem-sucedida.
1	Erro de autenticação	Verifique seu token de API e certifique-se de que sua assinatura está calculada corretamente.
2	Serviço ou parâmetros inválidos	Verifique se o nome do serviço e os parâmetros estão corretos.
5	Carteira não encontrada	Verifique o endereço da carteira ou entre em contato com o suporte se acreditar que isso é um erro.
6	Saldo insuficiente	Adicione fundos à sua conta ou reduza a quantidade de energia que você está solicitando.
10	Endereço TRON inválido	Verifique o formato do endereço TRON. Deve ser um endereço TRON válido de 34 caracteres.
11	Quantidade de energia inválida	Certifique-se de que a quantidade de energia solicitada é válida.
12	Duração inválida	Verifique se o parâmetro de duração é válido.
20	Transação não encontrada	Verifique se o ID da transação ou ID externo está correto.
24	Endereço não ativado	Ative o endereço primeiro fazendo uma transação de ativação de endereço.
25	Endereço já ativado	O endereço já está ativado. Nenhuma ação necessária.
500	Erro interno do servidor	Entre em contato com o suporte se este erro persistir.

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