Быстрый старт

Ниже минимальный путь от пустой интеграции до созданного заказа.

1. Создайте ключ

Откройте Панель управления → API, нажмите Создать API-ключ и сохраните два значения:

• api_key — открытый идентификатор ключа;
• api_secret — секрет, который показывается один раз.

Храните секрет только на сервере, например в RENTRON_API_SECRET. Не отправляйте его в браузер, мобильное приложение, URL или логи.

2. Проверьте время

curl https://api.rentron.xyz/v1/time

{"unix_time":1784376000}

Время подписанного запроса может отличаться от серверного не более чем на пять минут.

3. Получите параметры заказа

Подпишите GET /v1/energy/options. Ответ сообщает размер одной порции, допустимые сроки и доступность приёма заказов.

{"energy_per_portion":65000,"max_energy":1300000,"duration_hours":[1],"intake_enabled":true}

4. Создайте заказ

Отправляйте JSON компактно и подписывайте именно те байты, которые уйдут по сети.

{"client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"expected_total_trx":"3.200000"}

POST /v1/energy/orders HTTP/1.1
Host: api.rentron.xyz
Content-Type: application/json
Authorization: HMAC-SHA256 {api_key}:{base64_signature}
X-Request-Timestamp: 1784376000

Новый заказ возвращает 201 Created, JSON заказа и Location: /v1/energy/orders/{id}. Идентичный повтор возвращает тот же заказ с 200 OK. Передавайте точный total_trx из последней котировки. При energy_price_changed получите новую котировку и подтвердите заказ ещё раз: заказ и удержание не создавались.

5. Дождитесь финала

Опрашивайте URL из Location с интервалами 1, 2, 5, затем 10 секунд. Останавливайтесь только когда одновременно:

{"lifecycle_final":true,"delivery_final":true}

Подробности: получение заказа, опрос и повторы, формат ошибок.