Kod Araçları

HTTP Durum Kodları Sözlüğü

Tüm HTTP durum kodlarını açıklamalarıyla birlikte arayın. Kod numarası veya açıklama ile arama yaparak ihtiyacınız olan bilgiye hızlıca ulaşın.

Durum Kodu Ara

62 durum kodu bulundu

100

Continue

Sunucu, isteğin başlangıç kısmını aldı ve istemcinin isteğin geri kalanını göndermesini bekliyor. Büyük dosya yüklemelerinde istemciye devam edebileceğini bildirmek için kullanılır.

101

Switching Protocols

Sunucu, istemcinin protokol değiştirme talebini kabul etti. Genellikle HTTP'den WebSocket protokolüne geçiş sırasında kullanılır.

102

Processing

Sunucu isteği aldı ve işlemeye devam ediyor ancak henüz yanıt hazır değil. Uzun süren WebDAV işlemlerinde zaman aşımını önlemek için kullanılır.

103

Early Hints

Sunucu, nihai yanıtı hazırlarken istemciye ön bilgi gönderir. Tarayıcının CSS ve JavaScript gibi kaynakları önceden yüklemesini sağlamak için kullanılır.

200

İstek başarıyla tamamlandı. GET isteklerinde kaynak döndürülür, POST isteklerinde işlem sonucu iletilir. En yaygın başarı durum kodudur.

201

Created

İstek başarılı oldu ve yeni bir kaynak oluşturuldu. Genellikle POST veya PUT isteklerinin ardından, yeni bir kullanıcı kaydı veya veri girişi oluşturulduğunda döndürülür.

202

Accepted

İstek kabul edildi ancak henüz işlenmedi. Arka planda çalışacak uzun süreli işlemler (toplu e-posta gönderimi, rapor oluşturma gibi) için kullanılır.

203

Non-Authoritative Information

Sunucu isteği başarıyla işledi ancak döndürülen bilgi bir proxy veya ara sunucudan geldiği için orijinal kaynaktan farklı olabilir.

204

No Content

İstek başarılı oldu ancak döndürülecek içerik yok. Silme işlemleri veya kaydetme işlemleri gibi yanıt gövdesi gerektirmeyen durumlarda kullanılır.

205

Reset Content

İstek başarılı oldu ve istemcinin belge görünümünü sıfırlaması gerekiyor. Form gönderimi sonrası formun temizlenmesi gerektiğini bildirmek için kullanılır.

206

Partial Content

Sunucu, Range başlığıyla yapılan isteğin yalnızca bir bölümünü döndürüyor. Büyük dosyaların parça parça indirilmesinde ve video akışlarında kullanılır.

207

Multi-Status

Yanıt birden fazla kaynak için durum bilgisi içerir. WebDAV işlemlerinde birden fazla dosya üzerinde yapılan toplu işlemlerin sonuçlarını bildirmek için kullanılır.

208

Already Reported

Kaynak daha önce bir çoklu durum yanıtında bildirildi ve tekrar listelenmeyecek. WebDAV bağlam işlemlerinde tekrar eden bildirimleri önlemek için kullanılır.

226

IM Used

Sunucu, kaynağa uygulanan bir veya daha fazla örnek manipülasyonunun sonucunu döndürüyor. Delta kodlaması kullanılarak bant genişliğinden tasarruf sağlamak için kullanılır.

300

Multiple Choices

İstek için birden fazla olası yanıt var. İstemci, sunucunun sunduğu seçeneklerden birini tercih etmelidir. Farklı formatlardaki kaynaklar için kullanılabilir.

301

Moved Permanently

İstenen kaynak kalıcı olarak yeni bir URL'ye taşındı. Arama motorları eski URL'yi yenisiyle günceller. Site taşıma ve URL yapısı değişikliklerinde kullanılır.

302

Found

İstenen kaynak geçici olarak başka bir URL'de bulunuyor. Arama motorları orijinal URL'yi korur. Bakım sayfalarına veya geçici yönlendirmelerde kullanılır.

303

See Other

İsteğin yanıtı başka bir URL'de GET isteğiyle alınabilir. Form gönderimi sonrası sonuç sayfasına yönlendirmede (POST/Redirect/GET deseni) kullanılır.

304

Not Modified

Kaynak son istekten bu yana değişmedi. Tarayıcı önbelleğindeki sürümü kullanabilir. Bant genişliği tasarrufu sağlamak için önbellekleme mekanizmasında kullanılır.

305

Use Proxy

İstenen kaynağa yalnızca belirtilen proxy üzerinden erişilebilir. Güvenlik nedeniyle kullanımdan kaldırılmıştır ve modern tarayıcılar bu kodu genellikle desteklemez.

307

Temporary Redirect

İstenen kaynak geçici olarak başka bir URL'de. 302'den farkı, HTTP metodunun (POST, PUT vb.) değiştirilmemesi garanti edilir. HSTS yönlendirmelerinde kullanılır.

308

Permanent Redirect

İstenen kaynak kalıcı olarak yeni bir URL'ye taşındı ve HTTP metodu değiştirilmemeli. 301'in metod korumalı versiyonudur. API yönlendirmelerinde tercih edilir.

400

Bad Request

Sunucu, hatalı sözdizimi nedeniyle isteği işleyemiyor. Eksik veya geçersiz parametreler, bozuk JSON formatı gibi istemci taraflı hatalarda döndürülür.

401

Unauthorized

İstek, kimlik doğrulama gerektiriyor. Geçersiz veya eksik oturum bilgileri gönderildiğinde döndürülür. Giriş yapmadan korumalı bir kaynağa erişmeye çalışıldığında görülür.

402

Payment Required

Gelecekte kullanılmak üzere ayrılmış bir durum kodu. Bazı API'lerde ödeme gerektiren özelliklere erişim sırasında veya kota aşımında kullanılmaktadır.

403

Forbidden

Sunucu isteği anladı ancak yetkilendirme reddedildi. Kimlik doğrulanmış olsa bile kullanıcının bu kaynağa erişim izni yoktur. Yönetici paneli gibi kısıtlı alanlarda görülür.

404

Not Found

İstenen kaynak sunucuda bulunamadı. URL yanlış yazılmış, sayfa silinmiş veya taşınmış olabilir. İnternetin en bilinen hata kodudur.

405

Method Not Allowed

İstek için kullanılan HTTP metodu (GET, POST, PUT vb.) bu kaynak için izin verilmiyor. Örneğin salt okunur bir kaynağa POST isteği gönderildiğinde döndürülür.

406

Not Acceptable

Sunucu, istemcinin Accept başlığında belirttiği içerik türlerinden hiçbirini üretemez. İçerik pazarlığı başarısız olduğunda döndürülür.

407

Proxy Authentication Required

İstemcinin önce proxy sunucusuyla kimlik doğrulaması yapması gerekiyor. 401'e benzer ancak proxy sunucusu için geçerlidir. Kurumsal ağlarda sıkça görülür.

408

Request Timeout

Sunucu, istemciden beklenen isteği zamanında alamadı. Yavaş bağlantılar veya büyük dosya yüklemelerinde bağlantı zaman aşımına uğradığında döndürülür.

409

Conflict

İstek, kaynağın mevcut durumuyla çelişiyor. Eşzamanlı düzenleme çakışmaları veya zaten var olan bir kaydı tekrar oluşturmaya çalışıldığında döndürülür.

410

Gone

İstenen kaynak artık mevcut değil ve bir yönlendirme adresi de bulunmuyor. 404'ten farkı, kaynağın bilinçli olarak kaldırıldığının kesin olmasıdır.

411

Length Required

Sunucu, Content-Length başlığı olmayan isteği kabul etmiyor. Dosya yükleme gibi gövde içeren isteklerde içerik boyutunun belirtilmesi gerektiğinde döndürülür.

412

Precondition Failed

İstemcinin başlıklarda belirttiği ön koşullar sunucu tarafından karşılanamıyor. If-Match veya If-Unmodified-Since gibi koşullu isteklerde kullanılır.

413

Payload Too Large

İstek gövdesi sunucunun kabul etmeye hazır olduğundan daha büyük. Dosya yükleme boyutu sınırı aşıldığında döndürülür. Sunucu yapılandırmasıyla sınır ayarlanabilir.

414

URI Too Long

İstek URI'si sunucunun işleyebileceğinden daha uzun. Çok fazla query parametresi gönderildiğinde veya hatalı yönlendirme döngülerinde görülebilir.

415

Unsupported Media Type

İsteğin medya türü sunucu tarafından desteklenmiyor. JSON bekleyen bir API'ye XML gönderildiğinde veya desteklenmeyen dosya formatı yüklendiğinde döndürülür.

416

Range Not Satisfiable

İsteğin Range başlığında belirtilen aralık kaynağın boyutunu aşıyor. Kısmi dosya indirme işlemlerinde geçersiz byte aralığı istendiğinde döndürülür.

417

Expectation Failed

Sunucu, Expect başlığında belirtilen beklentiyi karşılayamıyor. Expect: 100-continue kullanılan büyük dosya yüklemelerinde sunucu desteği olmadığında döndürülür.

418

I'm a Teapot

Bir çaydanlık, kahve demleme isteğini reddeder. 1998 Nisan Şakası RFC 2324'ten gelen eğlenceli bir durum kodu. Gerçek uygulamalarda easter egg olarak kullanılır.

421

Misdirected Request

İstek, yanıt üretemeyen bir sunucuya yönlendirildi. HTTP/2 bağlantılarında yanlış sunucuya yönlendirilen isteklerde döndürülür.

422

Unprocessable Content

Sunucu isteğin içerik türünü anlıyor ve sözdizimi doğru ancak içerikteki talimatları işleyemiyor. Form doğrulama hatalarında yaygın olarak kullanılır.

423

Locked

İstenen kaynak kilitli ve erişilemiyor. WebDAV'da bir dosya başka bir kullanıcı tarafından düzenlenirken kilitlendiyse döndürülür.

424

Failed Dependency

İstek, başarısız olan başka bir isteğe bağımlı olduğu için başarısız oldu. WebDAV toplu işlemlerinde bağımlı işlemlerden biri başarısız olduğunda döndürülür.

425

Too Early

Sunucu, tekrar saldırılarına karşı savunmasız olabilecek bir isteği işleme riskini almıyor. TLS 1.3 Early Data ile gönderilen isteklerde kullanılır.

426

Upgrade Required

Sunucu, mevcut protokolü kullanarak isteği işlemeyi reddediyor ve istemcinin farklı bir protokole yükseltme yapması gerekiyor. HTTP'den HTTPS'ye geçiş zorunluluğunda kullanılır.

428

Precondition Required

Sunucu, isteğin koşullu olmasını gerektiriyor. Eşzamanlı güncelleme çakışmalarını önlemek için If-Match başlığının zorunlu tutulduğu durumlarda kullanılır.

429

Too Many Requests

İstemci belirli bir süre içinde çok fazla istek gönderdi. API hız sınırlaması (rate limiting) uygulandığında döndürülür. Retry-After başlığıyla bekleme süresi belirtilir.

431

Request Header Fields Too Large

İstek başlıkları sunucunun işleyebileceğinden büyük. Çok büyük çerezler veya aşırı uzun başlık değerleri gönderildiğinde döndürülür.

451

Unavailable For Legal Reasons

Kaynak, yasal nedenlerle kullanıma sunulmuyor. Hükümet sansürü, telif hakkı talepleri veya mahkeme kararıyla engellenen içeriklerde kullanılır. Fahrenheit 451 romanından esinlenmiştir.

500

Internal Server Error

Sunucu beklenmeyen bir durumla karşılaştı ve isteği işleyemedi. Kod hataları, yapılandırma sorunları veya işlenmeyen istisnalar en yaygın nedenlerdir.

501

Not Implemented

Sunucu, isteği yerine getirmek için gereken işlevselliği desteklemiyor. Henüz geliştirilmemiş API uç noktaları veya desteklenmeyen HTTP metodları için kullanılır.

502

Bad Gateway

Ağ geçidi veya proxy sunucusu, üst sunucudan geçersiz bir yanıt aldı. Arka uç sunucusu çökmüş veya yanıt vermiyorsa bu hata görülür.

503

Service Unavailable

Sunucu geçici olarak hizmet veremiyor. Bakım modu, aşırı yüklenme veya sunucu yeniden başlatma sırasında döndürülür. Genellikle geçici bir durumdur.

504

Gateway Timeout

Ağ geçidi veya proxy sunucusu, üst sunucudan zamanında yanıt alamadı. Arka uç sunucusu yavaş çalıştığında veya yanıt vermediğinde bu hata oluşur.

505

HTTP Version Not Supported

Sunucu, istekte kullanılan HTTP protokol sürümünü desteklemiyor. Çok eski veya çok yeni bir HTTP sürümü kullanıldığında döndürülür.

506

Variant Also Negotiates

Sunucuda dahili yapılandırma hatası var. İçerik pazarlığı sırasında seçilen varyant kendisi de pazarlığa giriyor ve döngüsel bir referans oluşuyor.

507

Insufficient Storage

Sunucuda isteği tamamlamak için yeterli depolama alanı yok. WebDAV sunucularında disk alanı dolduğunda döndürülür.

508

Loop Detected

Sunucu, isteği işlerken sonsuz bir döngü tespit etti. WebDAV'da kaynaklar arasında döngüsel bağımlılık olduğunda döndürülür.

510

Not Extended

İsteği işlemek için gereken ek uzantılar sunucu tarafından desteklenmiyor. HTTP Uzantı Çerçevesi bağlamında kullanılır ve pratikte nadiren karşılaşılır.

511

Network Authentication Required

İstemcinin ağa erişmek için kimlik doğrulaması yapması gerekiyor. Otel, havalimanı gibi yerlerdeki captive portal (yakalama portalı) ağlarında kullanılır.

Ne İşe Yarar?

HTTP Durum Kodları Sözlüğü, web geliştirme sürecinde karşılaşılan tüm HTTP yanıt kodlarını Türkçe açıklamalarıyla sunar. Bir API geliştirirken, hata ayıklarken veya sunucu yapılandırması yaparken hangi durum kodunun ne anlama geldiğini hızlıca bulabilirsiniz.

Durum kodları beş ana kategoriye ayrılır: 1xx bilgilendirme, 2xx başarı, 3xx yönlendirme, 4xx istemci hatası ve 5xx sunucu hatası. Her kategori farklı bir renk ile kodlanmıştır ve kod numarası veya açıklama metni üzerinden arama yapabilirsiniz.

Sıkça Sorulan Sorular

HTTP durum kodu nedir?

HTTP durum kodları, bir web sunucusunun istemciden (tarayıcı, uygulama vb.) gelen bir isteğe verdiği üç haneli sayısal yanıtlardır. Bu kodlar, isteğin başarılı olup olmadığını, bir hata oluşup oluşmadığını veya ek işlem gerekip gerekmediğini belirtir.

En sık karşılaşılan HTTP hata kodları hangileridir?

En yaygın hata kodları 404 (Bulunamadı), 500 (Sunucu Hatası), 403 (Yasaklandı), 401 (Yetkisiz) ve 503 (Hizmet Kullanılamıyor) kodlarıdır. Bu kodlar, web sitesi sorunlarının teşhisinde ilk bakılacak göstergelerdir.

301 ve 302 yönlendirme arasındaki fark nedir?

301 kalıcı yönlendirmedir ve arama motorlarına URL'nin tamamen değiştiğini bildirir. 302 ise geçici yönlendirmedir; orijinal URL hala geçerlidir ve gelecekte tekrar kullanılabilir. SEO açısından kalıcı değişiklikler için 301 tercih edilmelidir.

API geliştirmede hangi durum kodlarını kullanmalıyım?

RESTful API'lerde en çok kullanılan kodlar: 200 (başarılı GET), 201 (başarılı POST/oluşturma), 204 (başarılı silme), 400 (geçersiz istek), 401 (kimlik doğrulama gerekli), 403 (yetki yok), 404 (bulunamadı) ve 422 (doğrulama hatası) kodlarıdır.