Integração de API para TR.ENERGY

O que é uma chave API e porque é que a Tr.energy precisa dela?

Uma chave API é um mecanismo de autenticação especial utilizado para garantir a segurança do serviço API Tr.energy e impedir o acesso não autorizado aos seus dados. Trata-se de uma cadeia de caracteres única que o sistema gera e atribui a cada utilizador para confirmar a sua legitimidade no acesso à API. Os utilizadores são obrigados a incluir uma chave API no cabeçalho dos seus pedidos para provar a sua identidade. Isto evita possíveis ataques maliciosos e abusos, protegendo a integridade e a funcionalidade do nosso sistema.

Como obter a chave da API

1. Inicie sessão e aceda à página Definições para a secção API.

2. Clique no botão "Gerar" para obter a chave. O sistema irá então gerar uma chave API única para si.

3. Copie o token de chave de API gerado em seu aplicativo para autenticar sua identidade ao chamar o serviço de API Tr.energy.

4. Siga esta ligação familiarizar-se com o método de interação com a nossa API.

Notas

1. Não partilhe a sua chave de API com ninguém para evitar uma utilização indesejada da mesma.

2 Se a sua chave API for perdida ou vazada, por favor contacte o nosso apoio ao cliente - [email protected]

3. se precisar de mais assistência ou encontrar algum problema, envie-nos um e-mail - [email protected]

1. AUTORIZAÇÃO

Isto acontece automaticamente quando se utiliza a chave API no cabeçalho (Bearer Token).

2. CONTROLO DO SALDO

Utilizar o método GET 1.1. Show

3. CHEQUE

Utilizar o método GET 1.2. Top up

4. CRIAÇÃO E ATIVAÇÃO DO PEDIDO

Use o método POST 2.0 Create & Activate

Antes de enviar a energia, nosso sistema verificará automaticamente se o endereço está ativado na rede TRON. Caso não esteja, ele será ativado e o pagamento por este serviço será deduzido do saldo do usuário. Depois disso, a energia será enviada para o endereço.

Quando o parâmetro "webhook_url" estiver definido, após a conclusão do pedido, o servidor enviará uma solicitação POST:
{
"status": true,
"address": your_consumer_wallet_address
}

5. VISUALIZAÇÃO DA LISTA DE CONSUMIDORES DE ENERGIA

(Estas são as carteiras nas quais a energia é delegada).

Para visualizar 1 endereço, utilizar o método GET 2.3. Show

Para visualizar todos os endereços, utilizar o método GET 2.1. Index

6. ACTUALIZAR OS DADOS DOS CONSUMIDORES DE ENERGIA

(É possível alterar o nome do consumidor, a quantidade de energia, o período de aluguer de energia, o estado da renovação automática)

Utilizar o método PATCH 2.6. Update

7. CRIAÇÃO E ATIVAÇÃO DO PEDIDO (sequencialmente)

Use o método POST 2.2 Create, depois POST 2.4 Activate order

8. DESACTIVAÇÃO DE UMA ORDEM DE ENERGIA

Utilizar o método POST 2.5. Deactivate

9. REMOÇÃO DE UM CONSUMIDOR DE ENERGIA

Utilizar o método DELETE 2.8. Destroy

Como implementar o trabalho das carteiras de trânsito com TR.ENERGY

Cria uma nova carteira no seu sistema, aceita criptomoedas de clientes, verifica a pureza da transação. Se estiver satisfeito com o resultado, pode enviar esses fundos para a sua carteira principal. Para uma transação, são suficientes 64k-130k de energia (dependendo da carga da rede TRON) Para isso, é necessário criar uma ordem de energia nesta carteira

Use o método POST 2.0 Create & Activate. Crie uma solicitação com os seguintes parâmetros:

{
  "payment_period": 15,
  "address": "TY3dRk4eQ75dCrW7tUcCzggU9rnz4V111",
  "auto_renewal": 0,
  "resource_amount": 65150,
  "name": "transit-TY3dR"
}

Receber uma resposta ao pedido

{
  "data": {
    "id": 2416165,
    "name": "transit-TY3dR",
    "address": "TY3dRk4eQ75dCrW7tUcCzggU9rnz4V111",
    "resource": "ENERGY",
    "resource_amount": 65150,
    "estimated_cost_trx": 3.48,
    "desired_resource_amount": 65150,
    "creation_type": 2,
    "recharge_type": null,
    "payment_period": 15,
    "auto_renewal": false,
    "is_active": false,
    "activation_queue": false,
    "order": null,
    "threshold": null,
    "webhook_url": null,
    "activated_at": null,
    "deactivated_at": null,
    "created_at": "29-09-2025 08:44:18",
    "updated_at": "29-09-2025 08:44:18"
  },
  "status": true
}

Se você usou anteriormente o método POST 2.2 Create, então ative o pedido separadamente.

criar um pedido POST 2.4. Activate com os seguintes parâmetros:

core.tr.energy/api/consumers/{ID_seu_consumidor}/activate

Se o saldo for suficiente, aguarde alguns segundos para receber o recurso selecionado e você poderá realizar a transferência.