Schnellstart

Dies ist der kürzeste Weg von einer leeren Anbindung zur angelegten Bestellung.

1. Zugangsdaten anlegen

Öffnen Sie Dashboard → API, wählen Sie API-Schlüssel erstellen und sichern Sie beide Werte:

• api_key — die öffentliche Kennung der Zugangsdaten;
• api_secret — das Secret, das nur einmal angezeigt wird.

Halten Sie das Secret auf Ihrem Server, zum Beispiel in RENTRON_API_SECRET. Geben Sie es niemals an einen Browser, eine mobile App, eine URL oder ein Log weiter.

2. Serverzeit prüfen

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

{"unix_time":1784376000}

Der Zeitstempel einer signierten Anfrage darf höchstens fünf Minuten von der Serverzeit abweichen.

3. Bestelloptionen lesen

Signieren Sie GET /v1/energy/options. Die Antwort nennt die Einheitengröße, die erlaubten Laufzeiten und ob neue Bestellungen angenommen werden.

{"energy_per_portion":65000,"max_energy":1300000,"duration_minutes":[15,60,240,1440],"intake_enabled":true}

4. Bestellung anlegen

Serialisieren Sie das JSON genau einmal und signieren Sie exakt die Bytes, die Sie senden.

{"client_request_id":"order-1042","address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60,"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

Eine neue Bestellung liefert 201 Created, das Bestell-JSON und Location: /v1/energy/orders/{id}. Eine identische Wiederholung liefert die bestehende Bestellung mit 200 OK. Senden Sie den exakten total_trx des zuletzt eingeholten Angebots. Kommt energy_price_changed zurück, holen Sie ein neues Angebot ein und senden Sie erneut; es wurde weder eine Bestellung angelegt noch TRX reserviert.

5. Senden, sobald Energy nutzbar ist

Fragen Sie Location nach 1, 2 und 5 Sekunden ab, danach alle 10 Sekunden. Senden Sie Ihre eigene Transaktion, sobald energy_usable true wird:

{"status":"available","delivery_final":false,"energy_usable":true,"rental_expires_at":1784379612}

available bedeutet, dass die Energy der Adresse bereits zugeteilt ist und ausgegeben werden kann; das bezahlte Zeitfenster läuft bis rental_expires_at. Etwa eine Minute später bestätigt eine unabhängige Prüfung die Lieferung, und der Status wechselt auf delivered. Richten Sie sich nach energy_usable, nicht nach delivered — das Warten auf diese Prüfung verbraucht Mietzeit, die Sie bereits bezahlt haben.

6. Auf den Abschluss warten

Wenn Sie den vollständigen Mietzyklus protokollieren, fragen Sie weiter ab. Hören Sie erst auf, wenn beide Werte true sind:

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

Weiter geht es mit Bestellung abrufen, Polling und Wiederholungen und API-Fehlern.