Geliştirici dokümantasyonu

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

Sorgulama ve denemeler

// DOC

Ü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.