Rentron

Geliştirici dokümantasyonu

API çalışma alanı
https://api.rentron.xyz/v1
OpenAPI şeması

Üretim API’si · 7 uç nokta

Rentron Energy API

TRON Energy kiralamalarını fiyatlandırmak, oluşturmak ve izlemek için canlı API.

Hızlı başlangıcı aç Doğrulama

Hızlı istek

// 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 }

Uç nokta haritası

// 07

API temelleri

04
GET
/v1/time

İstekleri imzalamadan önce API Unix saatini okuyun ve saat sapmasını teşhis edin.

GET
/v1/balance

Sipariş oluşturmadan önce kullanılabilir ve ayrılmış TRX tutarını okuyun.

GET
/v1/energy/options

Geçerli Energy miktarlarını, kiralama sürelerini ve yeni siparişlerin açık olup olmadığını okuyun.

POST
/v1/energy/quotes

Hesap bakiyesini değiştirmeden bir TRON adresi için güncel kiralama fiyatını hesaplayın.

Energy siparişleri

03
POST
/v1/energy/orders

Tekrarlara dayanıklı bir Energy kiralaması oluşturun; sabit tutarı ve sorgulama URL'sini alın.

GET
/v1/energy/orders/{id}

Sahibi olduğunuz bir siparişi okuyun; teslimatın ve kiralama yaşam döngüsünün kesinleşip kesinleşmediğini belirleyin.

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

Siparişleri opak imleç sayfalamasıyla yeniden eskiye okuyun.

Genel bakış

// README

Rentron Energy API, panelde elle işlem yapmadan sunucunuz üzerinden TRON Energy kiralamanızı sağlar. Entegrasyon normal HTTPS istekleri, HMAC doğrulaması ve sipariş durumu sorgulaması kullanır.

Bir dakikalık özet

Ayar Değer
Temel URL https://api.rentron.xyz/v1
Biçim snake_case alanlı JSON
Doğrulama GET /v1/time dışında HMAC-SHA256
Sipariş güncellemeleri Yalnızca sorgulama; webhook veya callback yok
Hatalar RFC 9457, application/problem+json
OpenAPI https://rentron.xyz/openapi/rentron-energy-v1.json

API canlı hesap bakiyenizi kullanır. Ayrı bir sandbox API yoktur.

Sipariş akışı

  1. Güncel kiralama seçeneklerini okuyun ve fiyat isteyin.
  2. Benzersiz client_request_id ve teklifin tam total_trx değerini expected_total_trx olarak gönderin.
  3. Dönen id değerini ve Location başlığını saklayın.
  4. Hem lifecycle_final hem delivery_final true olana dek GET /v1/energy/orders/{id} çağrısını sorgulayın.

Sözleşme garantileri

  • Sunucu nihai tutarı sipariş oluşturulurken sabitler ve total_trx olarak döndürür.
  • Para değerleri tam altı ondalık basamaklı dizgelerdir.
  • Aynı client_request_id ile aynı isteği tekrar göndermek çift sipariş oluşturmaz.
  • Eksik veya başka hesaba ait sipariş kimlikleri aynı 404 yanıtını döndürür.
  • Uygulama mantığı detail metnini ayrıştırmamalı, kararlı hata code değerini kullanmalıdır.

Hızlı başlangıç ile devam edin; ardından doğrulama mantığını tek bir sunucu tarafı HTTP istemcisinde toplayın.