Ana içeriğe atla

Mevcut bir kaynağı değiştiren yazma işlemleri

Herhangi bir başlık gerekmez. Eskiden hata döndüren bir tekrar, artık mevcut durumu döndürür: Bir tekrar hiçbir şey yazmaz ve yanıtı Idempotent-Replayed: true başlığını taşır — “bunu ben iptal ettim” ile “zaten iptal edilmişti” arasındaki farkı bu başlıkla anlarsın. Üç istisna bunun yerine 409 döndürür:
  • Farklı bir activated_at ile etkinleştirme. Laboratuvar raporunda yer alan bilgi örnek alma zamanıdır, bu nedenle yeni bir deneme bunun üzerine sessizce yazmamalıdır.
  • Zaten iptal edilmiş bir randevuyu farklı bir cancellation_reason ile iptal etme. Aynı mantık: kayıtlı neden o zamandan beri düzeltilmiş olabilir ve yeni bir deneme bunun üzerine yazmamalıdır. Kayıtlı nedeni yeniden gönder veya alanı ekleme.
  • Geri dönüşü olmayan noktadan sonra iptal etme — onaylanmış bir kan alma, teslim alınmış bir gönderi, kargoya verilmiş veya etkinleştirilmiş bir kit.
Üç uç nokta bilinçli olarak yeniden denemeye güvenli değildir:

Yeni kaynak oluşturan yazma işlemleri

Beş uç nokta en fazla 255 karakter uzunluğunda isteğe bağlı bir Idempotency-Key başlığı kabul eder: Tek anahtar, dört deneme, tek sipariş — geri alacağın yanıt ne zaman yeniden denediğine ve gövdenin eşleşip eşleşmediğine bağlıdır: Sıralı diyagram: İlk istekten 350 ms sonra gönderilen yinelenen istek, ilk istek hâlâ çalışırken 409 yanıtı alır; ilk istek 201 döndürür; aynı anahtarla daha sonra yapılan yeniden deneme Idempotent-Replayed işaretli aynı siparişi döndürür ve değiştirilmiş gövdeyle aynı anahtar 409 döndürür. Sıralı diyagram: İlk istekten 350 ms sonra gönderilen yinelenen istek, ilk istek hâlâ çalışırken 409 yanıtı alır; ilk istek 201 döndürür; aynı anahtarla daha sonra yapılan yeniden deneme Idempotent-Replayed işaretli aynı siparişi döndürür ve değiştirilmiş gövdeyle aynı anahtar 409 döndürür. Anahtarlar API anahtarına ve uç noktaya göre kapsamlandırılır; bu yüzden başka bir iş ortağının anahtarlarıyla veya başka bir yerde kullanılan aynı anahtarla asla çakışmaz.
  • Aynı anahtar, aynı gövde → 24 saat boyunca Idempotent-Replayed: true işaretli ilk yanıtı geri alırsın. Alan sırası ve boşluklar önemli değildir.
  • Aynı anahtar, farklı gövde → 409.
  • Boş bir Idempotency-Key → yok sayılmak yerine 400.

Anahtar ne zaman serbest bırakılır

Oluşturma işlemi atomik değildir — bir 5xx yanıtı hiçbir şey yazılmadığı anlamına gelmez.
  • İstek herhangi bir şey oluşturulmadan önce başarısız olduysa → anahtar serbest bırakılır, yani aynı anahtarla yeniden deneyebilirsin.
  • İstek bir şey oluşturulduktan sonra başarısız olduysa veya hiç yanıt dönmediyse → anahtar ayrılmış kalır ve yeniden denemeler 409 alır. Var olup olmadığını kontrol etmek için kaynağı getir, yoksa yeni bir anahtar kullan.
Bir tekrar yanıtı, kaynak oluşturulduğunda kaydedilen yanıt gövdesini döndürür — canlı bir okuma değil, anlık görüntüdür. Kaynak o zamandan beri değiştiyse doğrudan kaynağı getir.

Bazı oluşturma işlemlerinin doğal bir anahtarı da vardır

İki uç nokta, herhangi bir başlıktan bağımsız olarak yinelenen istekleri kendi başına reddeder:
  • Randevu oluştur her profil, konum ve zaman noktası için tek bir randevuya izin verir. Bir tekrar, mevcut appointment_id değerini taşıyan 409 döndürür.
  • Profil oluştur, email adresine ait bir profil zaten varsa 409 döndürür. email alanını eklemezsen her istek için benzersiz bir yer tutucu oluşturulur, bu yüzden tekrarlar gerçekten de ayrı profiller oluşturur.
Her ikisi de geçerli olduğunda gördüğün yanıt doğal anahtar kaynaklı 409 olur ve ek alanı (appointment_id veya bir error_name ayırt edicisi) yalnızca o taşır — idempotency kaynaklı 409 yalnızca error taşır, bu yüzden bu alanları temkinli oku.