Docs

Idempotence

Son güncelleme: 2026-07-211 dk okuma

Ağ çağrıları başarısız olabilir. Bir POST isteğini işi - ve ödemeyi - iki kez yapmadan yinelemek için bir idempotence anahtarı gönderin: her mantıksal işlem için ürettiğiniz benzersiz bir değer (UUID iyi iş görür).

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1c8a90-1e2b-4c77-9a10-2b6d0f9e4a11" \
  -d '{"propertyCategory":"apartment","totalArea":50}'

Nasıl çalışır

  • Belirli bir anahtarla yapılan ilk istek normal çalışır ve sonucu önbelleğe alınır.
  • Aynı anahtarla yapılan yineleme özgün sonucu döndürür - araç yeniden çalışmaz ve yeniden ücret alınmaz.
  • İlk istek hâlâ sürüyorsa yineleme 409 döndürür (idempotence çakışması) - bekleyin ve yeniden deneyin.

Anahtarlar 24 saat hatırlanır.

Her ayrı işlem için yeni bir anahtar kullanın. Aynı anahtarı gerçekten farklı istekler için kullanmak, hepsine ilk sonucu döndürür.

Bu makale yardımcı oldu mu?