Geliştirici dokümantasyonu

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

Siparişleri listele

// GET

Üretim API’si

Siparişleri listeleyin

Siparişleri opak imleç sayfalamasıyla yeniden eskiye okuyun.

GET /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_invalid ile 400 döndürür.