Kısmi güncellemelerde JSON Merge Patch mı JSON Patch mı kullanmalıyım?
Kısmi güncellemede Merge Patch ile ETag/If-Match'i varsayılan yapın; JSON Patch'e yalnız eleman bazlı dizi ya da koşullu çok-alan işlemi gerekince geçin.
Etiket
Sözleşme, sürümleme ve kaynak modeli: bir API'yi kırmadan büyütmenin kuralları. Bu etiketle sorulan sorular ve cevapları.
Bu etikette 5 cevaplanmış soru var.
Kısmi güncellemede Merge Patch ile ETag/If-Match'i varsayılan yapın; JSON Patch'e yalnız eleman bazlı dizi ya da koşullu çok-alan işlemi gerekince geçin.
Değişikliklerin çoğunu alan ekleyerek yapın ve hiçbir alanı silmeyin; kaçınılmaz kırıcı değişikliği /v2 yerine bir versiyon header'ıyla pin'leyin.
7807 yerine onu güncelleyen RFC 9457'yi baz alın, üretimi tek bir exception handler'a toplayın ve type URI'sini sözleşme gibi yönetin.
openapi.yaml'ı tek doğru kaynak yapıp contract-first gidin; drift'i bitiren şey yön değil, CI'da spec'i koda karşı doğrulayan yeşil contract testtir.
Kullanımı partner bazında ölçün, her yanıta Sunset ve Deprecation başlığı koyun, tarihli sunset duyurup brownout yapın, kullanım sıfıra yaklaşınca kesin.