Skip to main content
Current API’deki kimliği doğrulanmış her POST, bir Idempotency-Key başlığı kabul eder. Anahtar içeren bir istek başarılı olduğunda, yanıtı 24 saat boyunca saklanır. Aynı anahtarla yeniden denemek, isteği tekrar yürütmek yerine saklanan yanıtı yeniden oynatır. Bu, sizin tarafınızda zaman aşımına uğrayan veya hata veren bir isteği; yinelenen bir ücretlendirme, transfer veya kaynak riski olmadan güvenle yeniden denemenizi sağlar. 255 bayta kadar herhangi bir benzersiz dize anahtar olarak kullanılabilir; UUID iyi bir varsayılandır. Her farklı işlem için yeni bir anahtar oluşturun ve bu anahtarın aynısını yalnızca o işlemi yeniden denemek için kullanın.
Yeniden oynatılan yanıtlar, durum kodu dahil orijinalle bayt bayt aynıdır ve bir yeniden oynatmayı yeni bir yürütmeden ayırt edebilmeniz için Idempotent-Replayed: true başlığı taşır.
Hata yanıtları da yeniden oynatılır. Orijinal istek bir 4xx ile başarısız olduysa, aynı anahtarla yeniden denemek aynı hatayı döndürür. Bu başarısızlık isteğin gerçek sonucuydu; bunun yerine düzeltilmiş istekle birlikte yeni bir anahtar gönderin.
Bilinmesi gereken birkaç ayrıntı:
  • “Aynı istek”, metot, yol, sorgu dizesi, gövde ve Api-Version-Date değerlerinin tamamının orijinalle tam olarak eşleşmesi anlamına gelir. Herhangi bir fark, anahtarın yeniden kullanımı olarak değerlendirilir ve error.code değeri idempotency_key_mismatch olan bir 400 ile reddedilir.
  • Anahtarlar, kimliği doğrulanmış çağırana göre kapsamlandırılır. İki farklı API anahtarı veya kullanıcı, çakışma olmadan aynı anahtar değerini kullanabilir.
  • Başlık, kimliği doğrulanmamış isteklerde ve POST dışındaki metotlarda yok sayılır; GET, PATCH ve DELETE istekleri güvenle yeniden denenebilir.
  • Bir anahtarla yapılan ilk istek hâlâ çalışırken, bir yeniden deneme error.code değeri idempotency_request_in_progress olan bir 409 döndürür. İlk istek bilinmeyen bir sonuçla başarısız olduysa (örneğin, istek ortasında bir sunucu çökmesi), yeniden denemeler anahtarın süresi dolana kadar bu 409 değerini döndürmeye devam eder. API bir isteği asla iki kez yürütme riskine girmez.