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 DE UMA ORDEM DE ENERGIA

Utilizar o método GET 2.2. Create

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 tipo de consumidor: dinâmico/estático, o estado da renovação automática)

Utilizar o método PATCH 2.7. Update

7. ACTIVAÇÃO DA ORDEM DE ENERGIA

Utilizar o método POST 2.4. Activate

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

Utilizamos o método POST 2.2. Create. Criar um pedido com os parâmetros seguintes:

{
  "payment_period": 1,
  "address": "TY3dRk4eQ75dCrW7tUcCzggU9rnz4V111",
  "auto_renewal": 0,
  "consumption_type": 1,
  "resource_amount": 70000,
  "name": "transit-TY3dR"
}

Receber uma resposta ao pedido

{
  "data": {
    "id": 1,
    "name": "transit-TY3dR",
    "address": "TY3dRk4eQ75dCrW7tUcCzggU9rnz4V1111",
    "resource_amount": "70000",
    "creation_type": 2,
    "consumption_type": 1,
    "payment_period": 1,
    "auto_renewal": false,
    "resource_consumptions": null,
    "is_active": false,
    "order": null,
    "created_at": "30-10-2023 06:58:17",
    "updated_at": "30-10-2023 06:58:17"
  },
  "status": true
}

Em seguida, ativar a encomenda com base nos dados recebidos

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 minutos para que a energia se encha e possa efetuar a transferência.