Rentron

Документация для разработчиков

Пространство API
https://api.rentron.xyz/v1
Схема OpenAPI

API для реальных заказов · 7 эндпоинтов

Rentron Energy API

API для расчёта стоимости, заказа и отслеживания аренды TRON Energy.

Открыть быстрый старт Аутентификация

Быстрый запрос

// CURL

POST /v1/energy/quotes

curl https://api.rentron.xyz/v1/energy/quotes \
  -X POST \
  -H "Authorization: HMAC-SHA256 {api_key}:{base64_signature}" \
  -H "X-Request-Timestamp: 1784376000" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TXYZ",
    "energy": 65000,
    "duration_hours": 1
  }'

200 OK

{ "total_trx": "3.200000", "can_afford": true }

Карта эндпоинтов

// 07

Основы API

04
GET
/v1/time

Получите Unix-время API перед подписью запросов и диагностируйте рассинхронизацию часов.

GET
/v1/balance

Прочитайте доступный и удержанный баланс TRX перед созданием заказа.

GET
/v1/energy/options

Узнайте допустимый объём Energy, сроки аренды и доступность приёма заказов.

POST
/v1/energy/quotes

Рассчитайте актуальную цену аренды для конкретного TRON-адреса без изменения баланса.

Заказы Energy

03
POST
/v1/energy/orders

Создайте идемпотентный заказ аренды Energy и получите зафиксированную сумму и URL для проверки статуса.

GET
/v1/energy/orders/{id}

Прочитайте текущее состояние одного принадлежащего аккаунту заказа и определите финал доставки.

GET
/v1/energy/orders?limit=20&cursor=...

Получайте заказы от новых к старым с помощью непрозрачного курсора.

Обзор

// README

Rentron Energy API позволяет серверному приложению арендовать TRON Energy без ручных действий в панели управления. Интеграция строится на HTTPS-запросах с HMAC-подписью и периодической проверке статуса заказа.

Главное за минуту

Параметр Значение
Базовый URL https://api.rentron.xyz/v1
Формат JSON, поля в snake_case
Авторизация HMAC-SHA256 для всех методов, кроме GET /v1/time
Статус заказа Опрос по запросу, без уведомлений и обратных вызовов
Ошибки RFC 9457, application/problem+json
OpenAPI https://rentron.xyz/openapi/rentron-energy-v1.json

API работает с основным балансом аккаунта. Отдельной тестовой среды нет.

Как проходит заказ

  1. Получите доступные параметры и расчёт цены.
  2. Создайте заказ с уникальным client_request_id и точным total_trx котировки в поле expected_total_trx.
  3. Сохраните id и URL из заголовка Location.
  4. Опрашивайте GET /v1/energy/orders/{id}, пока lifecycle_final и delivery_final не станут true.

Гарантии контракта

  • Итоговая сумма фиксируется сервером при создании и возвращается в total_trx.
  • Денежные значения передаются строками с шестью знаками после точки.
  • Повтор идентичного запроса с тем же client_request_id не создаёт дубль.
  • Чужой и отсутствующий заказ одинаково возвращают 404.
  • Машинная логика должна читать стабильное поле ошибки code, а не текст detail.

Начните с быстрого старта, затем перенесите подпись из раздела Аутентификация в один общий HTTP-клиент вашего сервера.