Geliştirici dokümantasyonu

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

Sorgulama ve denemeler

// DOC

Üretim API’si

Sorgulama, yeniden deneme ve tekrarlanabilirlik

Güvenle yeniden deneyin, Retry-After değerine uyun ve 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.

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.

Neden iki bayrak var?

delivery_final teslimat denemesinin, lifecycle_final ise kiralama yaşam döngüsünün tamamlandığını gösterir. Başarılı teslimattan sonra sipariş rental_finished olana kadar etkin kalabilir. Tek bayrak veya tek durum kontrolü erken tamamlanmaya yol açar.

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.