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_atile 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_reasonile 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.
- Kan almayı onayla — ikinci bir çağrı
409döndürür. - Sonuçları e-postayla gönder (
POST /v1/appointments/{id}/results/email) ve Sonuçları e-postayla gönder (POST /v1/home-kit-orders/{id}/results/email) — her çağrı bir e-posta gönderir. Zaman aşımı veya5xxsonrası yeniden deneme müşteriye yinelenen bir e-posta gönderebilir.
Yeni kaynak oluşturan yazma işlemleri
Beş uç nokta en fazla 255 karakter uzunluğunda isteğe bağlı birIdempotency-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:
- Aynı anahtar, aynı gövde → 24 saat boyunca
Idempotent-Replayed: trueiş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 yerine400.
Anahtar ne zaman serbest bırakılır
Oluşturma işlemi atomik değildir — bir5xx 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
409alı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_iddeğerini taşıyan409döndürür. - Profil oluştur,
emailadresine ait bir profil zaten varsa409döndürür.emailalanını eklemezsen her istek için benzersiz bir yer tutucu oluşturulur, bu yüzden tekrarlar gerçekten de ayrı profiller oluşturur.
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.