Rentron

Entwicklerdokumentation

API-Arbeitsbereich
https://api.rentron.xyz/v1
OpenAPI-Schema

Produktions-API · 7 Endpunkte

Rentron Energy API

Produktiv-API zum Kalkulieren, Bestellen und Verfolgen von TRON-Energy-Mieten.

Schnellstart öffnen Authentifizierung

Schnelle Anfrage

// 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_minutes": 60
  }'

200 OK

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

Übersicht der Endpunkte

// 07

API-Grundlagen

04
GET
/v1/time

Unix-Zeit der API vor dem Signieren lesen und Abweichungen der Uhr erkennen.

GET
/v1/balance

Verfügbares und reserviertes TRX lesen, bevor eine Bestellung angelegt wird.

GET
/v1/energy/options

Gültige Energy-Mengen, Mietdauern und die aktuelle Annahme neuer Bestellungen lesen.

POST
/v1/energy/quotes

Den aktuellen Mietpreis für eine TRON-Adresse berechnen, ohne das Guthaben zu verändern.

Energy-Bestellungen

03
POST
/v1/energy/orders

Eine idempotente Energy-Miete anlegen und ihren festen Betrag samt Polling-URL erhalten.

GET
/v1/energy/orders/{id}

Eine eigene Bestellung lesen, den Moment erkennen, ab dem die Energy nutzbar ist, und feststellen, ob Lieferung und Mietzyklus endgültig sind.

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

Bestellungen von neu nach alt lesen, mit undurchsichtigem Cursor als Seitenwechsel.

Überblick

// README

Mit der Rentron Energy API mietet Ihr Server TRON Energy, ohne dass jemand das Dashboard bedienen muss. Die Anbindung nutzt gewöhnliche HTTPS-Anfragen, HMAC-Authentifizierung und Polling auf den Bestellstatus.

Überblick in einer Minute

Einstellung Wert
Basis-URL https://api.rentron.xyz/v1
Format JSON mit snake_case-Feldern
Authentifizierung HMAC-SHA256, außer bei GET /v1/time
Statusänderungen Nur Polling; keine Webhooks, keine Callbacks
Fehler RFC 9457, application/problem+json
OpenAPI https://rentron.xyz/openapi/rentron-energy-v1.json

Die API arbeitet mit dem Guthaben Ihres Produktivkontos. Eine getrennte Sandbox-API gibt es nicht.

Ablauf einer Bestellung

  1. Lesen Sie die aktuellen Mietoptionen und holen Sie einen Preis ein.
  2. Legen Sie die Bestellung mit einer eindeutigen client_request_id an und senden Sie den exakten total_trx des Angebots als expected_total_trx.
  3. Speichern Sie die zurückgegebene id und den Location-Header.
  4. Fragen Sie GET /v1/energy/orders/{id} ab, bis lifecycle_final und delivery_final beide true sind.

Zusagen des Vertrags

  • Der Server legt den endgültigen Betrag beim Anlegen der Bestellung fest und gibt ihn als total_trx zurück.
  • Geldbeträge sind Zeichenketten mit exakt sechs Nachkommastellen.
  • Eine identische Anfrage mit derselben client_request_id erzeugt keine zweite Bestellung.
  • Unbekannte Bestell-IDs und IDs fremder Konten liefern dieselbe 404.
  • Die Anwendungslogik richtet sich nach dem stabilen code, niemals nach dem Text in detail.

Machen Sie mit dem Schnellstart weiter und bündeln Sie danach die Logik der Authentifizierung in einem einzigen serverseitigen HTTP-Client.