Skip to main content
Bir kaydın tek bir alanını değiştirmek için tüm gövdeyi göndermek zorunda değilsiniz. Her güncellenebilir kaynağın hem PUT hem PATCH endpoint’i vardır. PATCH gövdesi JSON Merge Patch (RFC 7386) kuralına göre kaydın mevcut haliyle birleştirilir, sonra PUT ile aynı doğrulamalardan geçer.

Örnek

Bir ürünün yalnızca açıklamasını değiştirmek için:
PATCH /api/v1/products/{productId}
Ürünün kodu, tanımı, birimi, KDV oranı ve diğer bütün alanları olduğu gibi kalır. Aynı isteği PUT ile gönderseydiniz gönderilmeyen alanların hepsi temizlenirdi. Bir alanı temizlemek için null gönderin:
PATCH /api/v1/products/{productId}

Dikkat edilecekler

Doğrulama, birleştirme sonrasındaki kayıt üzerinde çalışır. Zorunlu bir alanı null yaparsanız ("Code": null gibi) istek, o kaynağın zorunlu alan hatasıyla reddedilir.
  • Alan adları büyük/küçük harfe duyarsız eşleştirilir; description ile Description aynı alandır.
  • Bir alanın varsayılanı varsa (ör. ürün ProductType için 4), o alana null göndermek alanı varsayılanına döndürür.
  • Listeler birleştirilmez, olduğu gibi değiştirilir.
  • Gövde bir JSON nesnesi değilse istek 0002 ile reddedilir.
  • Kayıt okunup birleştirildikten sonra yazılır; aynı kaydı aynı anda değiştiren iki istekte son yazan kazanır.