ETag ve If-Match kayıp güncellemeyi nasıl önler?
ETag, sunucunun bir kaynak gösterimi için verdiği doğrulayıcıdır. If-Match ise istemcinin değişikliği belirli bir doğrulayıcı hâlâ geçerliyse uygulamasını ister. Böylece kullanıcı eski bir kopyayı düzenlerken araya giren değişiklik tespit edilebilir. If-Match referansı, bu koşullu güncelleme kullanımını açıklar.
İki kişi aynı notu açtığında ikisi de aynı başlangıç metnini görebilir. İlk kişi kaydeder, ikinci kişi kendi eski kopyasını gönderir. Sürüm kontrolü yoksa ikinci kayıt, ilk kişinin değişikliğini sessizce silebilir. Bir Kaydet düğmesi göstermek, bu çatışmanın nasıl çözüleceğini belirlemez.
İstemci okuduğu ETag'i nasıl geri gönderir?
İstemci, okuduğu gösterimin ETag değerini olduğu gibi saklayıp güncelleme isteğinde If-Match içine koyabilir. ETag opak bir değerdir; içindeki sayıyı artırmak veya değer biçiminden iş kuralı çıkarmak istemcinin görevi değildir.
Örnek bir not okumasının yanıtı:
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 17
ETag: "note-7"
{"title":"Draft"}
Bu gösterimi düzenleyen istemci, aşağıdaki gibi tam bir değiştirme isteği gönderebilir. Örnekte sunucu JSON gösterimini dönüştürmeden kaydeder:
PUT /api/notes/42 HTTP/1.1
Host: api.example.com
If-Match: "note-7"
Content-Type: application/json
Content-Length: 20
{"title":"Reviewed"}
Koşul sağlanıp kayıt tamamlandıysa örnek sunucu yeni doğrulayıcıyla yanıt verir:
HTTP/1.1 204 No Content
ETag: "note-8"
Başka bir origin üzerindeki API'nin ETag yanıtını JavaScript ile okuyabilmek, sunucunun bu başlığı uygun CORS politikasıyla açmasını gerektirebilir. If-Match istek başlığı da preflight izninde değerlendirilmelidir. CORS rehberi bu iki yönü ayırır.
412 Precondition Failed ne zaman döner?
412, istekteki önkoşulun karşılanmadığını bildirir. Bu örnekte kaynak artık note-8 iken If-Match: "note-7" ile gelen güncelleme uygulanmaz ve sunucu 412 döndürür. 412 referansı, eski gösterimi koruma kullanımını açıklar.
HTTP/1.1 412 Precondition Failed
Cache-Control: no-store
Content-Length: 0
İstemci bu yanıtı alınca yeni sürümü okuyup kullanıcının değişikliğiyle karşılaştırmalıdır. Yeni ETag'i otomatik alıp aynı eski içeriği tekrar göndermek, ilk kişinin değişikliğini yine silebilir. Çatışmayı görünür kılın; birleştirme veya yeniden düzenleme seçeneği sunun.
409 ve 428, 412'den nasıl ayrılır?
409, kaynak durumuyla çatışma olduğunu bildirir; 428 ise sunucunun isteği koşullu göndermeyi zorunlu tuttuğunu belirtir. Bu nedenle gerekli If-Match hiç yoksa seçilen API politikası 428, gönderilmiş koşul uyuşmuyorsa örnekte 412 kullanabilir. 409 referansı ve RFC 6585'in 428 tanımı, ayrımı destekler.
Tamamlanmış bir iş kaydının artık değiştirilememesi gibi durum çatışmaları, API sözleşmesine göre 409 ile anlatılabilir. Bütün 409 yanıtlarını ETag hatası saymak veya her başarısız güncellemeyi 412 yapmak doğru bir genelleme değildir.
428 kullanıyorsanız istemciye hangi önkoşulu göndermesi gerektiğini açıklayın. Yanıtı genel bir tekrar dene mesajına indirgemek, eksik başlığın kendiliğinden düzeleceği izlenimini verir.
Zayıf ETag veya yıldız sürüm denetimi sağlar mı?
If-Match güçlü karşılaştırma kullanır; W/ öneki olan zayıf ETag bu karşılaştırmada eşleşmez. If-Match: * ise belirli sürümü seçmek yerine mevcut bir gösterimin varlığını denetler. RFC 9110 bölüm 13.1.1, bu kuralları tanımlar.
Bu yüzden yıldız, kullanıcının okuduğu sürüm değişmedi demek değildir. Önbellekte kullanılan bütün doğrulayıcıları da yazma korumasına uygun kabul etmeyin. HTTP önbellekleme rehberi, okuma tarafındaki ETag kullanımını ele alır.
Sunucuda sürüm karşılaştırması nasıl uygulanmalı?
Sürüm kontrolü ve yazma kararı, araya başka bir güncelleme giremeyecek şekilde uygulanmalıdır. Önce uygulamada sürümü okuyup sonra koşulsuz UPDATE göndermek, okuma ile yazma arasında yeni bir yarış bırakır.
Veritabanı sürümüyle koşullu UPDATE veya uygun kilitleme stratejisi kullanın; etkilenen satır sayısını da işleyin. Gösterimdeki anlamlı değişikliklerin doğrulayıcıyı değiştirdiğinden emin olun. PostgreSQL transaction rehberi, atomik yazma kararını açıklar.
Kontrollerde aynı başlangıç sürümüyle iki güncelleme, eksik koşul, eski koşul ve yeniden okuma sonrası bilinçli güncelleme bulunmalıdır. Sadece HTTP kodunu değil, kayıtta hangi içeriğin kaldığını da doğrulayın.
Sık sorulan sorular
ETag yalnızca önbellekleme için mi kullanılır? Hayır. If-Match ile koşullu değişikliklerde de kullanılabilir.
412 alınca aynı isteği otomatik tekrarlamak yeterli mi? Hayır. Güncel veriyi ve kullanıcının değişikliğini değerlendirmek gerekir.
If-Match yetkilendirme sağlar mı? Hayır. Sunucu kimlik, kaynak yetkisi ve diğer doğrulama kurallarını ayrıca uygulamalıdır.

