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
- RFC 9110: HTTP Semantics, IETF (2022-06)
- Hypertext Transfer Protocol (HTTP) Status Code Registry, IANA (2025-09-15)
- RFC 2518: HTTP Extensions for Distributed Authoring -- WEBDAV, IETF (1999-02)
- RFC 8297: An HTTP Status Code for Indicating Hints, IETF (2017-12)
- RFC 4918: HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV), IETF (2007-06)
- RFC 5842: Binding Extensions to Web Distributed Authoring and Versioning (WebDAV), IETF (2010-04)
- RFC 3229: Delta encoding in HTTP, IETF (2002-01)
- RFC 8470: Using Early Data in HTTP, IETF (2018-09)
- RFC 6585: Additional HTTP Status Codes, IETF (2012-04)
- RFC 7725: An HTTP Status Code to Report Legal Obstacles, IETF (2016-02)
- RFC 2295: Transparent Content Negotiation in HTTP, IETF (1998-03)
- RFC 2774: An HTTP Extension Framework, IETF (2000-02)
- Module ngx_http_rewrite_module, nginx
- Module ngx_http_ssl_module, nginx
- Troubleshoot your Application Load Balancers, AWS Documentation
- Error 520, Cloudflare Docs
- Error 521, Cloudflare Docs
- Error 522, Cloudflare Docs
- Error 523, Cloudflare Docs
- Error 524, Cloudflare Docs
- Error 525, Cloudflare Docs
- Error 526, Cloudflare Docs
- Error 530, Cloudflare Docs
- RFC 2324: Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0), IETF (1998-04-01)