Polling und Wiederholungen

Rentron sendet weder Webhooks noch Callbacks. Maßgeblich ist GET /v1/energy/orders/{id}.

Empfohlenes Polling

Fragen Sie Location nach dem Anlegen nach 1, 2 und 5 Sekunden ab, danach alle 10 Sekunden. Streuen Sie die Abstände leicht, wenn Sie viele Bestellungen gleichzeitig verfolgen.

Senden Sie Ihre eigene Transaktion, sobald energy_usable true wird — die Energy liegt dann bereits auf der Adresse. Fragen Sie danach weiter ab und hören Sie erst auf, wenn lifecycle_final === true und delivery_final === true gilt.

Wiederholungsmatrix

Ergebnis	Vorgehen
Netzwerkfehler oder Zeitüberschreitung beim GET	Mit wachsendem Abstand wiederholen.
Zeitüberschreitung beim Anlegen der Bestellung	Exakt denselben Body und dieselbe client_request_id erneut senden.
429	Die in Retry-After genannten Sekunden abwarten.
500 oder 503 beim GET	Mit wachsendem Abstand und Streuung wiederholen.
400, 413, 415	Anfrage korrigieren; eine automatische Wiederholung hilft nicht.
401	Zugangsdaten, Signatur, Zeitstempel oder IP-Freigabe korrigieren.
409 Idempotenzkonflikt	Anhalten und prüfen, wo eine Client-ID doppelt verwendet wurde.

Drei Signale: eines zum Handeln, zwei zum Aufhören

energy_usable ist das Signal zum Handeln. Es wird schon in available true, etwa eine Minute vor delivered, und bedeutet, dass die Energy auf der Adresse liegt und ausgegeben werden kann. Auf delivered zu warten kostet nur Mietzeit, die bereits bezahlt ist.

delivery_final und lifecycle_final sind die Signale zum Aufhören. delivery_final schließt den Lieferversuch ab und bleibt in available false, weil die Lieferung dort noch nicht unabhängig bestätigt ist. lifecycle_final schließt die Mietdauer ab: Nach erfolgreicher Lieferung bleibt eine Bestellung aktiv, bis rental_finished erreicht ist. Wer bei energy_usable, bei nur einem Flag oder bei nur einem Status aufhört, beendet die Schleife zu früh.

Ratenbegrenzung

Die Grenzen gelten getrennt für die öffentliche Zeitabfrage, den authentifizierten Verkehr und das Anlegen von Bestellungen. Raten Sie die Werte nicht: maßgeblich sind 429 und Retry-After.