API интеграция для TR.ENERGY

Что такое ключ API и зачем он нужен Tr.energy?

API-ключ представляет собой специальный механизм аутентификации, применяемый для обеспечения безопасности API-сервиса Tr.energy и предотвращения несанкционированного доступа к вашим данным. Это уникальная строка, которую генерирует система и назначает каждому пользователю для подтверждения их легитимности при обращении к API. Пользователям необходимо включать API-ключ в заголовок своих запросов, чтобы доказать свою идентификацию. Это предотвращает возможные злонамеренные атаки и злоупотребления, защищая целостность и работоспособность нашей системы.

Как получить API ключ

1. Авторизуйтесь в системе и перейдите на страницу Настроек в раздел API.

2. Нажмите кнопку «Сгенерировать», чтобы получить ключ. Затем система сгенерирует для вас уникальный ключ API.

3. Скопируйте сгенерированный токен API-ключа в свое приложение, чтобы аутентифицировать свою личность при вызове службы API Tr.energy.

4. Пройдите по ссылке ознакомьтесь с методом взаимодействия с нашим API.

Примечания

1. Не раскрывайте свой ключ API никому, чтобы предотвратить его нежелательное использование.

2. Если ваш ключ API утерян, немедленно свяжитесь с нашей службой поддержки - [email protected]

3. Если вам нужна дополнительная помощь или вы столкнулись с какой-либо проблемой, напишите нам - [email protected]

1. АВТОРИЗАЦИЯ

Происходит автоматически при использования API ключа в header (Bearer Token)

2. ПРОВЕРКА БАЛАНСА

Используйте метод GET 1.1. Show

3. ПОПОЛНЕНИЕ БАЛАНСА

Используйте метод GET 1.2. Top up

4. СОЗДАНИЕ И АКТИВИРОВАНИЕ ЗАКАЗА

Используйте метод POST 2.0 Create & Activate

Перед отправкой энергии наша система автоматически проверит, активирован ли адрес в сети TRON. Если нет, она активирует его и спишет оплату за эту услугу с баланса пользователя. После этого энергия будет отправлена на адрес.

Когда установлен параметр "webhook_url", после выполнения заказа, сервер отправит POST-запрос:
{
"status": true,
"address": your_consumer_wallet_address
}

5. ВЫВОД СПИСКА ПОТРЕБИТЕЛЕЙ ЭНЕРГИИ

(Это кошельки, на которые делегируется энергия)

Чтобы отобразить 1 адрес используйте метод GET 2.3. Show

Чтобы отобразить все адреса используйте метод GET 2.1. Index

6. ОБНОВЛЕНИЕ ДАННЫХ ПОТРЕБИТЕЛЕЙ ЭНЕРГИИ

(Вы можете изменить имя потребителя, кол-во энергии, срок аренды энергии, статус автопродления)

Используйте метод PATCH 2.6. Update

7. СОЗДАНИЕ И АКТИВИРОВАНИЕ ЗАКАЗА (последовательно)

Используйте метод POST 2.2 Create, после этого POST 2.4 Activate order

8. ДЕАКТИВИРОВАНИЕ ЗАКАЗА ЭНЕРГИИ

Используйте метод POST 2.5. Deactivate

9. УДАЛЕНИЕ ПОТРЕБИТЕЛЯ ЭНЕРГИИ

Используйте метод DELETE 2.8. Destroy

Как реализовать работу транзитных кошельков с TR.ENERGY

Создаете новый кошелек в вашей системе, принимаете туда криптовалюту от клиентов, проверяете “чистоту” транзакции. Если вас устраивает результат, то можно отправлять эти средства на свой основной кошелек. Для одной транзакции достаточно 64к-130к энергии (в зависимости от наличия USDT на кошельке получателя). Для этого необходимо создать заказ энергии на этот кошелек

Используйте метод POST 2.0. Create & Activate. Создайте запрос со следующими параметрами:

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

Получаем ответ на запрос

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

Если ранее вы использовали метод POST 2.2. Create, тогда активируйте заказ отдельно.

создаем запрос POST 2.4. Activate со следующими параметрами:

core.tr.energy/api/consumers/{ID_вашего_потребителя}/activate

Если баланса достаточно, ожидайте несколько секунд получение выбранного ресурса и можете осуществлять перевод.