Integración de API para TR.ENERGY

¿Qué es una clave API y por qué Tr.energy la necesita?

La clave API es un mecanismo de autenticación especial que se utiliza para garantizar la seguridad del servicio API de Tr.energy y evitar el acceso no autorizado a sus datos. Se trata de una cadena única generada por el sistema y asignada a cada usuario para confirmar su legitimidad cuando accede a la API. Los usuarios deben incluir la clave API en el encabezado de sus solicitudes para comprobar su identidad. Esto evita posibles ataques maliciosos y abusos, protegiendo la integridad y el rendimiento de nuestro sistema.

Cómo obtener una clave de API

1. Inicie sesión en el sistema y vaya a la sección API de la página Configuración.

2. Haga clic en el botón "Generar" para obtener la clave. A continuación, el sistema generará una clave API única para usted.

3.Copie el token de la clave API generada en su app para autenticar su identidad cuando llame al servicio API de Tr.energy.

4. Sigue el enclace para conocer el método para interactuar con nuestra API.

Nota

1. No revele su clave API a nadie para evitar usos no deseados.

2. Si pierde su clave API, póngase en contacto con nuestro equipo de soporte inmediatamente - [email protected]

3. Si necesita más ayuda o se encuentra con algún problema, envíenos un correo electrónico - [email protected]

1. AUTORIZACIÓN

Esto ocurre automáticamente cuando se utiliza la clave API en la cabecera (Bearer Token).

2. COMPROBACIÓN DE SALDO

Utilice el método GET 1.1. Show

3. ARRIBA

Utilice el método GET 1.2. Top up

4. CREACIÓN Y ACTIVACIÓN DEL PEDIDO

Use el método POST 2.0 Create & Activate

Antes de enviar la energía, nuestro sistema verificará automáticamente si la dirección está activada en la red TRON. Si no lo está, se activará y el pago por este servicio se deducirá del saldo del usuario. Después de eso, la energía se enviará a la dirección.

Cuando el parámetro "webhook_url" esté configurado, después de que se complete el pedido, el servidor enviará una solicitud POST:
{
"status": true,
"address": your_consumer_wallet_address
}

5. VISUALIZACIÓN DE LA LISTA DE CONSUMIDORES DE ENERGÍA

(Son los monederos en los que se delega la energía).

Para mostrar 1 dirección utilice el método GET 2.3. Show

Para visualizar todas las direcciones utilice el método GET 2.1. Index

6. ACTUALIZACIÓN DE LOS DATOS DE LOS CONSUMIDORES DE ENERGÍA

(Puede cambiar el nombre del consumidor, la cantidad de energía, el periodo de arrendamiento de energía, el estado de renovación automática).

Utilice el método PATCH 2.6. Update

7. CREACIÓN Y ACTIVACIÓN DEL PEDIDO (secuencialmente)

Utiliza el método POST 2.2 Create, luego POST 2.4 Activate order

8. DESACTIVACIÓN DE UNA ORDEN DE ENERGÍA

Utilice el método POST 2.5. Deactivate

9. ELIMINACIÓN DE UN CONSUMIDOR DE ENERGÍA

Utilice el método DELETE 2.8. Destroy

Cómo implementar el trabajo de los monederos de tránsito con TR.ENERGY

Usted crea un nuevo monedero en su sistema, acepta criptodivisas de clientes allí, comprueba la pureza" de la transacción. Si está satisfecho con el resultado, puede enviar estos fondos a su monedero principal. Para una transacción, 64k-130k de energía es suficiente (dependiendo de la carga de la red TRON) Para ello, es necesario crear una orden de energía en esta cartera.

Utiliza el método POST 2.0 Create & Activate. Crea una solicitud con los siguientes parámetros:

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

Recibir una respuesta a la solicitud

{
  "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
}

Si anteriormente utilizaste el método POST 2.2 Create, entonces activa el pedido por separado.

crear una solicitud POST 2.4. Activate con los siguientes parámetros:

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

Si el saldo es suficiente, espera unos segundos para recibir el recurso seleccionado y podrás realizar la transferencia.