HTTP Durum Kodları


Nedir?

HTTP durum kodu, bir web sunucusunun her yanıtla birlikte gönderdiği ve isteğin sonucunu bildiren üç basamaklı sayıdır. Örneğin istek başarılı olduğunda 200, sayfa bulunamadığında 404 döner.[1] Geçerli kodlar 100 ile 599 arasındadır; ilk basamak yanıtın sınıfını belirtir.[1]

Kodlar RFC 9110 (HTTP Semantics, Haziran 2022) ve diğer IETF belgelerinde tanımlanır;[1] resmi liste, IANA'nın tuttuğu HTTP Status Code Registry'dir.[2] Koddan sonra gelen "Not Found" gibi kısa metne reason phrase (açıklama ifadesi) denir; yalnızca bir öneridir, sunucu onu değiştirebilir ya da hiç göndermeyebilir.[1] Bir istemci tanımadığı bir kodu, sınıfının x00 koduymuş gibi ele alır. Yani bilinmeyen bir 4xx kodu 400 olarak işlenir.[1]

Durum Kodu Sınıfları

Aşağıdaki tablo beş sınıfı ve anlamlarını gösterir.[1]

Sınıf Ad Anlamı
1xx Bilgilendirme İstek alındı, işlem sürüyor.
2xx Başarılı İstek alındı, anlaşıldı ve kabul edildi.
3xx Yönlendirme İsteği tamamlamak için ek bir işlem gerekiyor.
4xx İstemci Hatası İstekte söz dizimi hatası var ya da istek yerine getirilemiyor.
5xx Sunucu Hatası Sunucu, geçerli görünen bir isteği yerine getiremedi.

Durum Kodu Listesi

IANA kaydındaki 63 kodun tamamı (geçici kayıtlar hariç), resmi adlarıyla.[2] Her kodun kendi linki var. Örneğin bu sayfanın adresinin sonuna #404 eklemek doğrudan 404'e götürür.

1xx Bilgilendirme

Kod Ad Açıklama Tanımı
100 Continue İsteğin ilk kısmı alındı ve reddedilmedi; sunucu, isteğin tamamı geldikten sonra son yanıtı gönderecek. RFC 9110 15.2.1[1]
101 Switching Protocols Sunucu, istemcinin Upgrade başlığında istediği protokole geçmeyi kabul eder. RFC 9110 15.2.2[1]
102 Processing Sunucu isteği aldı ama işlemesi için daha fazla zamana ihtiyacı var; son yanıt daha sonra gelecek (WebDAV). RFC 2518[3]
103 Early Hints Son yanıttan önce, son yanıtta muhtemelen olacak başlık alanlarıyla gönderilir. RFC 8297[4]

2xx Başarılı

Kod Ad Açıklama Tanımı
200 OK İstek başarılı oldu. RFC 9110 15.3.1[1]
201 Created İstek başarılı oldu ve yeni bir kaynak oluşturdu; kaynak genellikle Location başlığında verilir. RFC 9110 15.3.2[1]
202 Accepted İstek işlenmek üzere kabul edildi ama işlem henüz bitmedi. RFC 9110 15.3.3[1]
203 Non-Authoritative Information İstek başarılı oldu ama araya giren bir proxy, asıl sunucunun 200 yanıtının içeriğini değiştirdi. RFC 9110 15.3.4[1]
204 No Content İstek başarılı oldu ve geri gönderilecek içerik yok. RFC 9110 15.3.5[1]
205 Reset Content İstek başarılı oldu; istemci veri giriş alanını (örneğin bir formu) yeni giriş için sıfırlamalı. RFC 9110 15.3.6[1]
206 Partial Content Sunucu, kaynağın yalnızca istenen kısımlarını gönderir (aralık isteği, range request). RFC 9110 15.3.7[1]
207 Multi-Status Birbirinden bağımsız birden fazla işlemin durumunu tek yanıtta verir (WebDAV). RFC 4918[5]
208 Already Reported Bir koleksiyonun üyeleri aynı yanıtta daha önce listelendi, bu yüzden tekrarlanmaz (WebDAV). RFC 5842[6]
226 IM Used Yanıt, kaynağın güncel hâline uygulanan dönüşümlerin (örneğin bir fark/delta) sonucudur. RFC 3229[7]

3xx Yönlendirme

Kod Ad Açıklama Tanımı
300 Multiple Choices Kaynağın birden fazla gösterimi var ve istemci bunlardan birini seçebilir. RFC 9110 15.4.1[1]
301 Moved Permanently Kaynağın yeni ve kalıcı bir URL'si var; sonraki istekler onu kullanmalı. RFC 9110 15.4.2[1]
302 Found Kaynak geçici olarak başka bir URL'de; istemci asıl URL'yi kullanmaya devam etmeli. RFC 9110 15.4.3[1]
303 See Other İstemciyi başka bir kaynağa (Location başlığı) yönlendirir; istemci onu GET veya HEAD ile alabilir. RFC 9110 15.4.4[1]
304 Not Modified Kaynak, istemcideki kopyadan bu yana değişmedi; istemci kendi kopyasını kullanabilir. RFC 9110 15.4.5[1]
305 Use Proxy Kullanımdan kaldırıldı (deprecated). RFC 9110 15.4.6[1]
306 (Unused) Artık kullanılmıyor; kod ayrılmış (reserved) durumda. RFC 9110 15.4.7[1]
307 Temporary Redirect Kaynak geçici olarak başka bir URL'de; yönlendirme izlenirken istek metodu değişmemeli. RFC 9110 15.4.8[1]
308 Permanent Redirect Kaynağın yeni ve kalıcı bir URL'si var; 307 gibi istek metodunu korur. RFC 9110 15.4.9[1]

4xx İstemci Hatası

Kod Ad Açıklama Tanımı
400 Bad Request Sunucu, istemci kaynaklı bir hata (örneğin bozuk söz dizimi) yüzünden isteği işleyemez veya işlemez. RFC 9110 15.5.1[1]
401 Unauthorized İstekte geçerli kimlik doğrulama bilgisi yok. RFC 9110 15.5.2[1]
402 Payment Required İleride kullanılmak üzere ayrılmış. RFC 9110 15.5.3[1]
403 Forbidden Sunucu isteği anladı ama yerine getirmeyi reddediyor. RFC 9110 15.5.4[1]
404 Not Found Sunucu bu URL'de bir şey bulamadı ya da bir şeyin var olduğunu açıklamak istemiyor. RFC 9110 15.5.5[1]
405 Method Not Allowed Metot (örneğin POST) biliniyor ama bu kaynak desteklemiyor; izin verilen metotlar Allow başlığında listelenir. RFC 9110 15.5.6[1]
406 Not Acceptable Hiçbir gösterim istemcinin Accept başlıklarına uymuyor ve sunucu varsayılan bir gösterim göndermiyor. RFC 9110 15.5.7[1]
407 Proxy Authentication Required 401 gibi, ama istemcinin bir proxy'ye kimlik doğrulaması yapması gerekir. RFC 9110 15.5.8[1]
408 Request Timeout Sunucu, beklemeye razı olduğu süre içinde isteğin tamamını alamadı. RFC 9110 15.5.9[1]
409 Conflict İstek, kaynağın şu anki durumuyla çakışıyor. RFC 9110 15.5.10[1]
410 Gone Kaynak artık yok ve bu büyük olasılıkla kalıcı. RFC 9110 15.5.11[1]
411 Length Required Sunucu, Content-Length başlığı olmadan isteği kabul etmez. RFC 9110 15.5.12[1]
412 Precondition Failed İstek başlıklarındaki bir koşul (örneğin If-Match) sunucuda yanlış çıktı. RFC 9110 15.5.13[1]
413 Content Too Large İstek gövdesi, sunucunun işlemeye razı ya da muktedir olduğundan büyük. RFC 9110 15.5.14[1]
414 URI Too Long URL, sunucunun yorumlamaya razı olduğundan uzun. RFC 9110 15.5.15[1]
415 Unsupported Media Type İstek içeriğinin biçimi desteklenmiyor. RFC 9110 15.5.16[1]
416 Range Not Satisfiable Kaynağın istenen aralık(lar)ı verilemiyor. RFC 9110 15.5.17[1]
417 Expectation Failed Expect başlığındaki beklenti karşılanamadı. RFC 9110 15.5.18[1]
418 (Unused) Ayrılmış; bir 1 Nisan şakası RFC'sinden gelen "I'm a teapot" olarak bilinir (aşağıdaki SSS'ye bakın). RFC 9110 15.5.19[1]
421 Misdirected Request İstek, bu URL için yetkili yanıt veremeyen bir sunucuya gitti. RFC 9110 15.5.20[1]
422 Unprocessable Content İstek doğru biçimde, ama sunucu içindeki talimatları işleyemiyor. RFC 9110 15.5.21[1]
423 Locked Kaynak kilitli (WebDAV). RFC 4918[5]
424 Failed Dependency Metot başarısız oldu, çünkü bağlı olduğu başka bir işlem başarısız oldu (WebDAV). RFC 4918[5]
425 Too Early Sunucu, tekrar oynatılabilecek (replay) bir isteği işleme riskine girmiyor (TLS early data). RFC 8470[8]
426 Upgrade Required İstemci, Upgrade başlığında belirtilen başka bir protokole geçmeli. RFC 9110 15.5.22[1]
428 Precondition Required Sunucu, "kaybolan güncelleme" (lost update) sorununu önlemek için isteğin koşullu olmasını ister. RFC 6585[9]
429 Too Many Requests İstemci belli bir sürede çok fazla istek gönderdi (hız sınırı); Retry-After başlığı ne kadar bekleneceğini söyleyebilir. RFC 6585[9]
431 Request Header Fields Too Large İstek başlık alanları çok büyük. RFC 6585[9]
451 Unavailable For Legal Reasons Erişim, yasal bir talep yüzünden engellendi. RFC 7725[10]

5xx Sunucu Hatası

Kod Ad Açıklama Tanımı
500 Internal Server Error Sunucu, isteği yerine getirmesini engelleyen beklenmedik bir durumla karşılaştı. RFC 9110 15.6.1[1]
501 Not Implemented Sunucu gereken işlevi (örneğin tanımadığı bir metodu) desteklemiyor. RFC 9110 15.6.2[1]
502 Bad Gateway Bir ağ geçidi (gateway) veya proxy, arkasındaki sunucudan geçersiz bir yanıt aldı. RFC 9110 15.6.3[1]
503 Service Unavailable Sunucu, örneğin aşırı yük veya bakım nedeniyle isteği geçici olarak karşılayamıyor. RFC 9110 15.6.4[1]
504 Gateway Timeout Bir ağ geçidi (gateway) veya proxy, arkasındaki sunucudan zamanında yanıt alamadı. RFC 9110 15.6.5[1]
505 HTTP Version Not Supported Sunucu, isteğin ana HTTP sürümünü desteklemiyor. RFC 9110 15.6.6[1]
506 Variant Also Negotiates Seçilen varyantın kendisi de içerik pazarlığı yapacak şekilde ayarlanmış; bu bir sunucu yapılandırma hatasıdır. RFC 2295[11]
507 Insufficient Storage Sunucu, isteği tamamlamak için gerekeni depolayamıyor (WebDAV). RFC 4918[5]
508 Loop Detected Sunucu, sonsuz bir döngüyle karşılaştığı için işlemi durdurdu (WebDAV). RFC 5842[6]
510 Not Extended (Obsoleted) İstek, kaynağa erişim politikasını karşılamadı; kod artık geçersiz (obsolete). RFC 2774[12]
511 Network Authentication Required İstemcinin ağa erişmek için kimlik doğrulaması yapması gerekir; "captive portal" giriş sayfaları için düşünülmüştür. RFC 6585[9]

Standart Dışı Durum Kodları

Bazı web sunucuları, framework'ler ve CDN'ler IANA kaydında olmayan kodlar kullanır. Böyle bir kodu tanımayan tarayıcı onu sınıfının x00 kodu gibi ele alır; yani 520, 500 gibi işlenir.[1]

Kod Ad Kullanan Açıklama
419 Page Expired Laravel Formun CSRF anahtarı eksik ya da süresi dolmuş; örneğin sayfa çok uzun süre açık kaldığında.
444 No Response nginx nginx, yanıt başlığı göndermeden bağlantıyı kapatır.[13]
495 SSL Certificate Error nginx İstemci sertifikası doğrulanamadı.[14]
496 SSL Certificate Required nginx İstemci gerekli sertifikayı göndermedi.[14]
497 HTTP Request Sent to HTTPS Port nginx Düz bir HTTP isteği HTTPS portuna gönderildi.[14]
499 Client Closed Request nginx İstemci, sunucu yanıt vermeden bağlantıyı kapattı; nginx kayıtlarında (log) görülür.
460 - AWS ALB İstemci, yük dengeleyicinin boşta kalma süresi dolmadan bağlantıyı kapattı.[15]
463 - AWS ALB X-Forwarded-For başlığında çok fazla IP adresi var (30'dan fazla).[15]
464 - AWS ALB İsteğin protokolü, hedef grubun protokol sürümüyle uyumsuz.[15]
520 Web server returns an unknown error Cloudflare Asıl sunucu (origin) boş, bilinmeyen ya da beklenmedik bir yanıt gönderdi.[16]
521 Web server is down Cloudflare Asıl sunucu, Cloudflare'in bağlantılarını reddediyor.[17]
522 Connection timed out Cloudflare Cloudflare, asıl sunucuya bağlanmaya çalışırken zaman aşımına uğradı.[18]
523 Origin is unreachable Cloudflare Cloudflare asıl sunucuya ulaşamıyor.[19]
524 A timeout occurred Cloudflare Cloudflare asıl sunucuya bağlandı ama 125 saniye içinde HTTP yanıtı alamadı.[20]
525 SSL handshake failed Cloudflare Cloudflare ile asıl sunucu arasındaki SSL/TLS el sıkışması başarısız oldu.[21]
526 Invalid SSL certificate Cloudflare Cloudflare, asıl sunucunun SSL sertifikasını doğrulayamıyor.[22]
530 - Cloudflare Cloudflare, asıl sunucunun alan adını çözümleyemiyor.[23]
561 Unauthorized AWS ALB Yük dengeleyici kullanıcıyı doğrularken kimlik sağlayıcı (IdP) bir hata döndürdü.[15]

Sık Sorulan Sorular

401 ile 403 Arasındaki Fark Nedir?

401 Unauthorized, istekte geçerli kimlik bilgisi olmadığı anlamına gelir; istemci yeni ya da değiştirilmiş bilgilerle tekrar deneyebilir.[1] 403 Forbidden ise sunucunun isteği anladığı ama reddettiği anlamına gelir; kimlik bilgisi gönderildiyse sunucu onları yetersiz bulur ve istemci isteği aynı bilgilerle tekrarlamamalıdır.[1]

301, 302, 307 ve 308 Arasındaki Fark Nedir?

Kod Taşınma POST, GET'e dönebilir
301 Moved Permanently Kalıcı Evet
302 Found Geçici Evet
307 Temporary Redirect Geçici Hayır
308 Permanent Redirect Kalıcı Hayır

Tarihsel nedenlerle tarayıcı, bir 301 veya 302 yönlendirmesini izlerken POST isteğini GET'e çevirebilir; 307 ve 308 ise asıl metodu her zaman korur, bu yüzden bir formu ya da API isteğini yönlendirmek için güvenli seçimdir.[1]

502 ile 504 Arasındaki Fark Nedir?

İkisi de asıl sunucunun önünde duran bir ağ geçidinden veya proxy'den (yük dengeleyici, CDN gibi) gelir. 502 Bad Gateway, arkadaki sunucunun geçersiz bir yanıt gönderdiği anlamına gelir. 504 Gateway Timeout ise arkadaki sunucunun zamanında yanıt vermediği anlamına gelir.[1]

418 I'm a Teapot Gerçek Bir Durum Kodu mu?

Tam olarak değil. "418 I'm a teapot", 1 Nisan 1998'de bir 1 Nisan şakası olarak yayımlanan RFC 2324'ten (Hyper Text Coffee Pot Control Protocol) gelir. Bu RFC'de kahve demlemesi istenen bir çaydanlık 418 ile yanıt verir.[24] Şaka olarak o kadar çok kullanıldı ki kod artık ayrılmış (reserved) ve "(Unused)" olarak işaretli; ancak 4xx kodları bir gün tükenirse başka bir anlam verilebilir.[1]

Silinen Sayfa İçin 404 mü, 410 mu?

İkisi de sayfanın orada olmadığını söyler. 410 Gone buna kaldırılmanın büyük olasılıkla kalıcı olduğunu ekler; site bakımı için, örneğin süresi biten bir kampanya sayfası için düşünülmüştür.[1] 404 Not Found ise sayfanın geri gelip gelmeyeceği hakkında bir şey söylemez; bu yüzden sayfanın kalıcı olarak kaldırıldığını biliyorsanız 410, bilmiyorsanız 404 kullanın.[1]

Kaynaklar

  1. RFC 9110: HTTP Semantics, IETF (2022-06)
  2. Hypertext Transfer Protocol (HTTP) Status Code Registry, IANA (2025-09-15)
  3. RFC 2518: HTTP Extensions for Distributed Authoring -- WEBDAV, IETF (1999-02)
  4. RFC 8297: An HTTP Status Code for Indicating Hints, IETF (2017-12)
  5. RFC 4918: HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV), IETF (2007-06)
  6. RFC 5842: Binding Extensions to Web Distributed Authoring and Versioning (WebDAV), IETF (2010-04)
  7. RFC 3229: Delta encoding in HTTP, IETF (2002-01)
  8. RFC 8470: Using Early Data in HTTP, IETF (2018-09)
  9. RFC 6585: Additional HTTP Status Codes, IETF (2012-04)
  10. RFC 7725: An HTTP Status Code to Report Legal Obstacles, IETF (2016-02)