Sipariş sorgulayın

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":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60,"total_trx":"3.200000","status":"delivered","lifecycle_final":false,"delivery_final":true,"created_at":1784376000,"updated_at":1784376073,"energy_usable":true,"rental_expires_at":1784379612}

Değeri olmayan alan yanıta null olarak konmaz, hiç gelmez: adrese henüz ulaşmamış bir siparişte rental_expires_at anahtarı yoktur, başarılı bir siparişte de failure anahtarı bulunmaz. Gelmeyen anahtarı null olarak okuyun, alanın bulunmasını şart koşmayın.

Alan	Tür	Açıklama
status	string	created, executing, available, delivered, rental_finished, failed veya rental_interrupted.
energy_usable	boolean	Energy adresinizde ve harcanabilir durumda. rental_expires_at gelmediği sürece hem available hem de delivered için true; o an geçtiğinde false olur, durum bir süre daha delivered görünse bile: kiralamanın bitişi kesinleşmiş zincir kanıtıyla doğrulanır.
rental_expires_at	integer, değer yoksa gelmez	Ödediğiniz kiralama süresinin bittiği Unix saniyesi. Energy adrese ulaşana kadar anahtar gelmez; failed durumunda yine gelmez, çünkü bloke tutar tümüyle iade edilir ve süre onunla birlikte geçersiz olur. rental_interrupted durumunda süre korunur: o kiralama gerçekten işledi, yalnızca yarıda kesildi.
lifecycle_final	boolean	Kiralamanın tamamı bitti; başka geçiş olmayacak.
delivery_final	boolean	Teslimat denemesi bitti. available durumunda hâlâ false, çünkü teslimat henüz bağımsız olarak kanıtlanmadı. true tek başına başarı anlamına gelmez; failure alanını inceleyin.
failure	object, değer yoksa gelmez	failed durumunda code: energy_delivery_failed, rental_interrupted durumunda code: energy_delivery_interrupted ile gelir. Her ikisi de bu kararlı code değerini ve güvenli bir message taşır.
created_at, updated_at	integer	Unix saniyeleri.

İşleminizi ne zaman göndermelisiniz?

Kararınızı delivered durumuna değil, energy_usable alanına dayandırın.

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

available, Energy'nin adrese tahsis edildiği ve harcanabildiği anlamına gelir; ödediğiniz süre rental_expires_at değerine kadar işlemektedir. Yaklaşık bir dakika sonra bağımsız doğrulama teslimatı kanıtlar ve durum delivered olur; rental_expires_at bu sırada değişmez. delivered beklemek yalnızca ödediğiniz kiralama süresini tüketir.

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