Geliştirici dokümantasyonu

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

Sipariş sorgula

// GET

Üretim API’si

Sipariş sorgulayın

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/{id}
Bu sayfada

Sipariş oluşturma sonucundaki UUID'yi veya Location başlığındaki yolu kullanın.

Yol parametresi

Parametre Tür Açıklama
id UUID Genel sipariş kimliği.

Yanıt 200

{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"delivered","lifecycle_final":false,"delivery_final":true,"created_at":1784376000,"updated_at":1784376012,"failure":null}
Alan Tür Açıklama
status string created, executing, delivered, rental_finished, failed veya rental_interrupted.
lifecycle_final boolean Kiralamanın tamamı bitti; başka geçiş olmayacak.
delivery_final boolean Teslimat denemesi bitti. true tek başına başarı anlamına gelmez; failure alanını inceleyin.
failure object veya null Başarısız sonuçtaki kararlı code ve güvenli message.
created_at, updated_at integer Unix saniyeleri.

Sorgulamayı ne zaman durdurmalı?

Yalnızca iki kesinlik bayrağı da true olduğunda durun. Başarılı tam yaşam döngüsü rental_finished ile biter. failed ve rental_interrupted durumlarında failure bulunur.

Bulunamadı

Eksik kimlikler ve başka hesaba ait kimlikler bilerek aynı yanıtı döndürür:

{"type":"https://rentron.xyz/docs/errors/codes#energy_order_not_found","title":"Not Found","status":404,"detail":"Order was not found.","code":"energy_order_not_found"}