Códigos de Erro

Quando uma chamada de API falha, a resposta contém um code diferente de zero e uma mensagem error legível por humanos.

Formato da resposta de erro

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

Campo	Descrição
code	Código de erro inteiro diferente de zero.
key	Nome do campo que causou o erro, quando aplicável. String vazia caso contrário.
request_id	Identificador único da requisição. Inclua ao contatar o suporte.
error	Descrição legível por humanos do erro.

Códigos de status HTTP

Status HTTP	Significado
200	Requisição bem-sucedida (code: 0) ou erro de nível de aplicação (code: non-zero).
429	Limite de requisições excedido — 1 requisição/segundo/IP nos endpoints /v1/orders*.
422	Requisição não processável — validação falhou (também retornado como code: non-zero no corpo).
500	Erro interno do servidor — falha inesperada do nosso lado.

Casos de erro comuns

Situação	Causa provável
address_from ou address_to inválido	Não é um endereço TRON válido (deve começar com T, 34 caracteres).
duration diferente de 1	Apenas aluguéis de 1 hora são suportados.
energy e bandwidth ambos iguais a 0	Pelo menos um recurso deve ser solicitado.
energy ou bandwidth fora dos limites	A quantidade solicitada está abaixo do mínimo ou acima do máximo para este projeto.
Pedido ativo duplicado	Um pedido ativo para o mesmo par address_from + address_to já existe no status new.
order_id não encontrado	O order_id passado para check ou cancel não existe.
Limite de requisições excedido	Você está enviando mais de 1 requisição/segundo do mesmo IP. Aguarde e tente novamente.
referral_code muito longo	A string referral_code excede 64 caracteres.

Tratamento de erros

1. Sempre verifique code no corpo da resposta — HTTP 200 não garante sucesso.
2. Registre request_id junto com qualquer erro para depuração.
3. Para HTTP 429, implemente recuo exponencial antes de tentar novamente.
4. Para duplicate active order, use Verificar Pedido para recuperar o pedido existente em vez de criar um novo.