Üretim API’si
Sorgulama ve denemeler
Güvenle yeniden deneyin, Retry-After değerine uyun, energy_usable true olur olmaz harekete geçin ve yalnızca iki kesinlik bayrağı da true olduğunda sorgulamayı durdurun.
Bu sayfada
Rentron webhook veya callback göndermez. GET /v1/energy/orders/{id} tek doğru kaynaktır.
Önerilen sorgulama
Oluşturduktan sonra Location yolunu 1, 2, 5 saniye sonra; ardından her 10 saniyede bir sorgulayın. Çok sayıda siparişi birlikte takip ederken küçük rastgele gecikme ekleyin.
energy_usable true olur olmaz kendi işleminizi gönderin: Energy o anda adresinizde tahsis edilmiş durumdadır. Ardından sorgulamayı sürdürün ve yalnızca lifecycle_final === true ve delivery_final === true olduğunda durun.
Yeniden deneme matrisi
| Sonuç | İşlem |
|---|---|
| Ağ hatası / GET zaman aşımı | Artan beklemeyle yeniden deneyin. |
| Sipariş POST zaman aşımı | Aynı gövdeyi ve client_request_id değerini tekrar gönderin. |
429 |
Retry-After ile belirtilen saniye kadar bekleyin. |
GET üzerinde 500 / 503 |
Artan bekleme ve rastgele gecikmeyle yeniden deneyin. |
400, 413, 415 |
İsteği düzeltin; otomatik deneme yardımcı olmaz. |
401 |
Kimlik bilgisini, imzayı, zaman damgasını veya IP izin listesini düzeltin. |
409 tekrarlanabilirlik çakışması |
Durun ve yeniden kullanılan istemci kimliklerini inceleyin. |
Üç sinyal: biri harekete geçmek, ikisi durmak için
Harekete geçeceğiniz alan energy_usable. delivered durumundan yaklaşık bir dakika önce, available durumunda true olur ve Energy'nin adrese tahsis edilip harcanabildiği anlamına gelir. delivered beklemek yalnızca ödediğiniz kiralama süresini tüketir.
Duracağınız alanlar delivery_final ve lifecycle_final. delivery_final teslimat denemesini kapatır ve available durumunda hâlâ false kalır, çünkü teslimat henüz bağımsız olarak kanıtlanmamıştır. lifecycle_final ise kiralama süresini kapatır: başarılı teslimattan sonra sipariş rental_finished olana kadar etkin kalır. energy_usable üzerinden, tek bir bayrak üzerinden ya da tek bir durum üzerinden durmak döngüyü çok erken bitirir.
Oran sınırları
Oran sınırları, herkese açık GET /v1/time istekleri, doğrulanmış trafik ve sipariş oluşturma için ayrı ayrı uygulanır. Sınır değerlerini tahmin etmeyin; 429 ve Retry-After sözleşmenin parçasıdır.
Rentron