Saltar para o conteúdo principal

​
Autenticação por Chave de API

Todas as requisições da API exigem uma chave de API enviada no cabeçalho X-API-Key.

​
Obtendo uma chave de API

  1. Cadastre-se em tronrental.com
  2. Acesse Painel → Chaves de API
  3. Clique em Criar Chave de API
  4. Copie e armazene sua chave com segurança — ela é exibida apenas uma vez

​
Lista de IPs permitidos (opcional)

Você pode restringir sua chave de API a endereços IP específicos para segurança adicional. Configure isso no painel ao criar ou editar uma chave.

​
Permissões da chave

Cada chave de API tem escopos (scopes): as operações que ela pode realizar. Você os escolhe no painel ao criar ou editar uma chave. Uma chave nova recebe todos os escopos de leitura e escrita (comprar energia e largura de banda, Smart Mode, consultar saldo e histórico, entre outros), exceto withdraw: esse escopo é ativado separadamente e exige 2FA e uma lista de IPs permitidos. Uma solicitação fora dos escopos da chave é recusada com HTTP 403. A lista completa: Listar escopos de chaves de API.
Mantenha sua chave de API em sigilo. Não a exponha em código do lado do cliente, repositórios públicos ou URLs.

​
Chaves do Node API

O Node API — acesso a nós completos TRON em node.tronrental.com — tem chaves próprias. Você as cria como endpoints em Painel → Node API. Uma chave do Node API funciona apenas no nó: esta API a recusa com 403 NODE_API_KEY_ONLY. As chaves de API descritas nesta página também não funcionam no nó. Veja Node API → Endpoints e chaves.

​
Uso da chave e registro de solicitações

Cada solicitação autenticada com uma chave de API é guardada por 7 dias: método, caminho, código de status, latência e IP do cliente. Os parâmetros de consulta não são exibidos nesta visão. Abra Dashboard → API Keys e expanda uma chave para ver suas solicitações recentes; a coluna Last Used mostra a chamada mais recente (a marca de autenticação é atualizada no máximo uma vez a cada 5 minutos; o registro é exato). O registro está disponível apenas no painel — uma chave de API não pode ler o próprio registro.

​
Limites de Taxa

O limite de taxa é contado por conta, não por chave: todas as chaves de uma conta compartilham um único orçamento. Consulte Limites de Taxa para detalhes.

​
Erros

Erros de autenticação retornam HTTP 401:
Se sua chave estiver desabilitada ou bloqueada, você receberá HTTP 403.