Üretim API’si
Siparişleri listeleyin
Siparişleri opak imleç sayfalamasıyla yeniden eskiye okuyun.
/v1/energy/orders?limit=20&cursor=...Bu sayfada
Uç nokta yalnızca API kimlik bilgisine bağlı hesabın siparişlerini döndürür.
Sorgu parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
limit |
integer | 20 |
1 ile 100 arasındaki sayfa boyutu. |
cursor |
string | — | Önceki next_cursor değerinden gelen opak değer. |
İmza, başındaki ? dahil tam sorgu dizgesini içerir. İmzaladıktan sonra sıralamayı veya kodlamayı değiştirmeyin.
Yanıt 200
{"items":[{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TJRabPrwbZy45sbavfcjinPJC18kjpRTv8","energy":65000,"duration_minutes":60,"total_trx":"3.200000","status":"created","lifecycle_final":false,"delivery_final":false,"created_at":1784376000,"updated_at":1784376000,"energy_usable":false}],"next_cursor":"opaque-value"}
items yeniden eskiye sıralıdır. Son sayfada next_cursor anahtarı null olarak değil, hiç gönderilmez; bu yüzden anahtar gelmediğinde durun — açık bir null arayan denetim listenin sonunu göremez. Kayıt içindeki alanlar da aynı biçimde davranır: yukarıdaki siparişte bu değerler henüz oluşmadığı için rental_expires_at ve failure anahtarları yoktur.
Her kayıt siparişin tamamını taşır: status (created, executing, available, delivered, rental_finished, failed, rental_interrupted), energy_usable ve rental_expires_at. Hangi adreslerin şu anda Energy harcayabildiğini bulmak için status == "delivered" yerine energy_usable alanına göre süzün: available durumundaki bir sipariş zaten kullanılabilir ve ödenen süresi işlemektedir; süresi dolmuş bir sipariş ise durumu hâlâ delivered görünse de artık harcanamaz. Ayrıntılar: siparişi sorgulama.
İmleç kuralları
- İmleci değiştirmeden aktarın.
- Kendi başınıza çözmeyin veya üretmeyin.
- İmleç, ait olduğu hesap ve kaynağa bağlıdır.
- İmleç, verildikten 24 saat sonra çalışmaz. Ertesi gün kaldığınız yerden devam etmek için saklamayın; imleçsiz baştan başlayın.
- Geçersiz, değiştirilmiş, süresi dolmuş veya başka hesaba ait imleç
pagination_cursor_invalidile400döndürür.
Rentron