Tutorial

Content-Type ve Accept Farkı: HTTP 415 ve 406 Rehberi

Mehmet Fatih Ünal
7 Kasım 2026
7 dk okuma
#HTTP#Content-Type#Accept#Fetch API#FormData
Content-Type ve Accept Farkı: HTTP 415 ve 406 Rehberi

Content-Type ve Accept hangi yönü tarif eder?

Content-Type mesajdaki gövdenin medya türünü tanımlar; Accept ise istekte, istemcinin kabul ettiği yanıt medya türlerini bildirir. İstek ve yanıt farklı türde gövdeler taşıyabilir. Content-Type referansı ile Accept referansı, bu iki başlığın rollerini açıklar.

Bir istemcinin “JSON gönderiyorum” demesi, sunucunun mutlaka JSON döndüreceği anlamına gelmez. Aynı biçimde Accept: application/json yazmak, gönderilen metni JSON'a dönüştürmez. Gövdeyi üretme, gövdeyi tanımlama ve yanıt tercihini bildirme ayrı adımlardır.

Bir JSON isteği nasıl görünür?

Aşağıdaki temsili API sözleşmesi, not oluştururken JSON gövdesi alır ve JSON yanıtı sunar. Örnekteki adresler gerçek bir servisi göstermez:

POST /notes HTTP/1.1
Host: api.example.test
Content-Type: application/json
Accept: application/json
Content-Length: 15

{"title":"Not"}

Content-Type, gönderilen 15 baytlık gövdeyi tanımlar. Accept karşı yöndeki yanıt tercihini belirtir. Sunucunun başarılı yanıtı şu şekilde olabilir:

HTTP/1.1 201 Created
Content-Type: application/json
Location: /notes/1

{"id":1,"title":"Not"}

Tarayıcıdaki karşılığı aşağıdaki bağımsız yardımcıdır. İçeriği önce JSON'a çevirir, başlıkları ayarlar ve başarısız HTTP durumunu kontrol eder:

async function createNote(title) {
  const response = await fetch('/notes', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Accept: 'application/json',
    },
    body: JSON.stringify({ title }),
  });
  if (!response.ok) throw new Error('HTTP ' + response.status);
  return response.json();
}

Başlığa JSON yazıp gövdeye JavaScript nesnesini doğrudan vermek aynı işlem değildir. Bu yardımcı da genel bir API istemcisi değildir: başarı gövdesinin JSON olduğu bu örnek sözleşmeye dayanır. Problem Details rehberi, hata gövdesini ayrı ele alır.

HTTP 415 hangi tarafa bakmayı gerektirir?

415 Unsupported Media Type, bu işlem için desteklenmeyen istek içeriğine işaret eder. 415 referansı, medya türünün yanında içerik kodlamasının da ilgili olabileceğini açıklar.

Örnek API yalnızca JSON alıyorsa application/xml ile gönderilen bir notu reddedebilir:

HTTP/1.1 415 Unsupported Media Type
Content-Length: 0
Cache-Control: no-store

Burada önce istek başlığını ve gerçek gövdeyi karşılaştırın. Gövde XML ise sadece başlığı JSON yapmak sorunu çözmez. Gerçekten JSON göndermek gerekir. JSON medya türü doğru ama gövde bozuksa sözdizimi hatası farklı bir durumdur; bunun yanıtını API sözleşmesi belirler, her ayrıştırma hatasını 415 saymayın.

HTTP 406 ne zaman görülebilir?

406 Not Acceptable, sunucu istemcinin yanıt tercihlerini karşılayamadığında ve bu tercihleri yok sayarak yanıt vermeyi seçmediğinde kullanılabilir. 406 referansı ve HTTP Semantics standardı, bu içerik anlaşması davranışını açıklar.

Yalnızca JSON sunan ve katı içerik anlaşması uygulayan örnek API'ye Accept: image/png gönderilirse şu boş yanıt seçilebilir:

HTTP/1.1 406 Not Acceptable
Content-Length: 0
Cache-Control: no-store

Bu, bütün servislerin aynı isteğe mutlaka 406 döneceği anlamına gelmez. API'nin tercihleri nasıl uyguladığını belgeleyin. Accept birden fazla tür, joker veya kalite değeri içerebilir; içinde “json” kelimesini aramak tam bir anlaşma algoritması değildir. Özellikle q=0 ile dışlanan türü kabul edilmiş saymayın.

FormData gönderirken Content-Type neden elle ayarlanmaz?

Tarayıcıya FormData verdiğinizde multipart gövdeyle eşleşen boundary parametresini tarayıcının üretmesine izin verin. FormData rehberi, Content-Type başlığını elle sabitlememe nedenini açıklar.

async function uploadFile(file) {
  const body = new FormData();
  body.append('file', file);
  const response = await fetch('/uploads', {
    method: 'POST',
    headers: { Accept: 'application/json' },
    body,
  });
  if (!response.ok) throw new Error('HTTP ' + response.status);
  return response.json();
}

Burada Accept yine yanıt tercihidir. Content-Type: multipart/form-data değerini boundary olmadan elle eklemek, başlık ile gerçek gövdeyi uyumsuz bırakabilir. Kullanılan aracın tarayıcı mı yoksa başka bir çalışma ortamı mı olduğunu da kontrol edin; örnek özellikle tarayıcı Fetch davranışını gösterir.

Hata ayıklamada nasıl ilerlenir?

Ağ panelinde dört bilgiyi yan yana inceleyin: istek Content-Type, gönderilen gerçek gövde, Accept ve yanıt Content-Type. Beklenen durum kodunu da ekleyin. Başlık değişikliğinin tek başına veri dönüştürmediğini her adımda hatırlayın.

Geçerli JSON, desteklenmeyen tür, bozuk JSON ve karşılanmayan yanıt tercihi için ayrı testler kurun. Tarayıcının yanıtı okuyamaması her zaman medya türü hatası değildir; CORS rehberi farklı origin kurallarını açıklar. Başarısız isteği sürekli tekrar göndermek yerine önce hangi sözleşmenin bozulduğunu belirleyin.

Sık sorulan sorular

Accept gönderilen gövdenin türünü belirler mi? Hayır. Yanıt tercihidir; gönderilen gövdeyi Content-Type tanımlar.

415 ile 406 aynı hata mı? Hayır. İstek içeriğinin desteği ile yanıt tercihlerinin karşılanması farklı sorunlardır.

Her GET isteğine Content-Type gerekir mi? Gövde taşımayan bir GET için sırf JSON yanıt bekleniyor diye eklemek gerekmez. Yanıt tercihini Accept ile ifade edebilirsiniz.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar