REST API'de PUT metodundan bahsedin.

PUT yöntemi, belirli URI üzerinde kaynak oluşturmak veya güncellemek için kullanılır.

Ana özellikler:

• İdempotentlik: Aynı PUT isteğinin tekrar edilmesi, aynı gövde ile, sunucudaki kaynağın aynı duruma ulaşmasını sağlar (yanıt farklı olabilir).
• Tam değiştirme: PUT isteği, kaynağın tam bir temsilini gönderir ve mevcut kaynağı değiştirir.
• Oluşturma veya güncelleme: Belirtilen URI'de kaynak yoksa, PUT onu oluşturur. Varsa, günceller. Başarılı bir PUT isteğinde kaynağın olmaması genellikle 201 Created durum kodunu döner. Var olan kaynağın güncellenmesi genellikle 200 OK veya 204 No Content (gövde yoksa) ile sonuçlanır.

Tipik kullanım senaryoları:

• Kullanıcı profilinin tam güncellenmesi.
• Müşteri URI'sini belirlediğinde kaynak oluşturma.

PUT isteği örneği:

PUT /users/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "id": 123,
  "name": "Yeni İsim",
  "email": "new.email@example.com"
}

Sunucu bu isteği alır ve ya id=123 olan kullanıcıyı oluşturur ya da bu ID'ye sahip kullanıcının bilgilerini gövde verileriyle tamamen değiştirir.

PUT ile POST arasındaki farklar:

• PUT, bilinen bir URI üzerinde kaynak güncellemek veya oluşturmak için kullanılır, bu URI istemci tarafından belirlenir. POST ise, yeni bir kaynak oluşturmak için kullanılır ve sunucu yeni kaynağın URI'sini belirler veya diğer işlemler için kullanılır.
• PUT idempotenttir, POST değildir. Aynı gövde ile tekrar edilen POST istekleri, birden fazla aynı kaynağı oluşturabilir veya farklı yan etkiler yaratabilir.

PUT ve POST karşılaştırma tablosu:

Özellik	PUT	POST
Amaç	Kaynak oluşturma veya güncelleme	Kaynak oluşturma, veri gönderme
İdempotentlik	Evet	Hayır
URI belirleme	İstemci tarafından belirlenir	Sunucu tarafından belirlenir
Kaynak üzerindeki etkisi	Tamamen değiştirir veya oluşturur	Genellikle ekler veya işlem yapar