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.- “Aynı istek”, metot, yol, sorgu dizesi, gövde ve
Api-Version-Datedeğerlerinin tamamının orijinalle tam olarak eşleşmesi anlamına gelir. Herhangi bir fark, anahtarın yeniden kullanımı olarak değerlendirilir veerror.codedeğeriidempotency_key_mismatcholan bir400ile 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
POSTdışındaki metotlarda yok sayılır;GET,PATCHveDELETEistekleri güvenle yeniden denenebilir. - Bir anahtarla yapılan ilk istek hâlâ çalışırken, bir yeniden deneme
error.codedeğeriidempotency_request_in_progressolan bir409dö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 bu409değerini döndürmeye devam eder. API bir isteği asla iki kez yürütme riskine girmez.

