HTTP Durum Kodu Sorgulama

200, 404, 500 ve aradaki her şey dahil olmak üzere herhangi bir HTTP durum kodunu, ne anlama geldiğine ve sunucuların ne zaman döndürdüğüne dair sade Türkçe bir açıklamayla arayın.

HTTP Durum Kodu Sorgulama nedir?

HTTP durum kodları, bir web sunucusunun her yanıtla birlikte geri gönderdiği ve istemciye (tarayıcı, uygulama veya API tüketicisi) isteğin başarılı olup olmadığını, yönlendirmeye ihtiyaç duyup duymadığını veya başarısız olup olmadığını — ve nedenini — bildiren üç basamaklı sayılardır. IETF tarafından standartlaştırılmıştır ve her web sunucusunda, tarayıcıda ve programlama dilinde aynı şekilde kullanılır; bu da onları yazılım geliştirmede en evrensel hata ayıklama referanslarından biri yapar.

Bu sorgulama aracı, beş kategorinin tümünde en sık karşılaşılan kodları kapsar — bilgilendirici (1xx), başarı (2xx), yönlendirme (3xx), istemci hatası (4xx) ve sunucu hatası (5xx) — ve her birinin sadece resmi RFC tanımını değil, pratikte gerçekte ne anlama geldiğini sade Türkçeyle açıklar.

Formül

1xx: Bilgilendirici — istek alındı, işlem devam ediyor

2xx: Başarı — istek başarıyla alındı ve kabul edildi

3xx: Yönlendirme — isteği tamamlamak için ek işlem gerekiyor

4xx: İstemci Hatası — istek hatalı sözdizimi içeriyor veya yerine getirilemiyor

5xx: Sunucu Hatası — sunucu geçerli bir isteği yerine getiremedi

Nasıl Hesaplanır

Arama kutusuna bir durum kodu (404 gibi) veya bir anahtar kelime ("yasak" gibi) yazın.
Belirli bir aralığa göz atmak istiyorsanız 1xx-5xx düğmelerini kullanarak kategoriye göre filtreleyin.
Kodun ne anlama geldiğine ve tipik olarak ne zaman döndürüldüğüne dair sade Türkçe açıklamayı okuyun.
API yanıtlarında hata ayıklarken veya hata işleme oluştururken bunu hızlı bir referans olarak kullanın.

Örnek

"429" araması "Too Many Requests" sonucunu döndürür — API'lerin bir hız sınırını aştığınızda döndürdüğü ve yavaşlayıp bir gecikmeden sonra yeniden denemenizi söyleyen kod.

Temel Faydalar

Yaygın olarak kullanılan her durum kodu tek bir aranabilir referansta
Sadece resmi RFC ifadesi değil, sade Türkçe açıklamalar
Kategoriye göre (1xx'ten 5xx'e) anında filtreleme
Ücretsiz, hızlı, kayıt gerektirmez

Kaçınılması Gereken Yaygın Hatalar

Aslında başarısız olan bir istek için 200 OK döndürerek hataları izleme araçlarından gizlemek
401 (kimlik doğrulanmamış) ile 403'ü (kimlik doğrulanmış ama yetkisiz) karıştırmak
Kalıcı olması gereken bir yönlendirme için 302 kullanarak (301 yerine) SEO'ya zarar vermek
İstemci tarafı hata işlemede tüm 4xx ve 5xx hatalarını belirli koda göre dallandırmak yerine aynı şekilde ele almak

Uzman İpuçları

5xx kodlarını yalnızca sunucu tarafı hatalar için ayırın — asla istemci girdi hatalarını belirtmek için kullanmayın
Hız sınırlaması yaparken Retry-After başlığıyla birlikte 429 kullanın, böylece düzgün çalışan istemciler ne zaman yeniden deneyeceğini bilir
Bir kaynak gerçekten mevcut olmadığında genel bir hata sayfası yerine 404'ü tercih edin — hem kullanıcılar hem de arama motorları için daha iyidir
Bir API tasarlarken, her şey için varsayılan olarak genel bir 400 kullanmak yerine belirli 4xx kodlarını (422, 409, 400) seçin

Anahtar Terimler Açıklandı

Durum satırı: Durum kodunu ve kısa bir neden ifadesini içeren HTTP yanıtının ilk satırı
İdempotent: Aynı isteği tekrarlamanın bir kez yapmakla aynı etkiye sahip olduğu bazı HTTP yöntemlerinin özelliği
Yönlendirme zinciri: Bir tarayıcının son kaynağa ulaşmadan önce takip ettiği birden fazla yönlendirme dizisi
Hız sınırlama: Bir istemcinin belirli bir zaman diliminde yapabileceği istek sayısını kısıtlamak, genellikle 429 ile belirtilir

Yaygın Kullanım Alanları

Entegre olduğunuz bir API'nin döndürdüğü tanıdık olmayan bir durum kodunu hızlıca anlama
Belirli bir hata durumu için kendi API'nizden hangi durum kodunun döndürüleceğine karar verme
Belirli bir kodun gerçekte ne ima ettiğini kontrol ederek bir isteğin neden başarısız olduğunu hata ayıklama
Bir web geliştirme kursunda HTTP temellerini öğretme veya öğrenme
Farklı 4xx ve 5xx durumları ayırt eden doğru hata işleme mantığı yazma

Sıkça Sorulan Sorular

Farklı HTTP durum kodu aralıkları ne anlama gelir?

1xx kodları bilgilendiricidir, 2xx başarı anlamına gelir, 3xx yönlendirmeyi belirtir, 4xx istemcinin bir hata yaptığı anlamına gelir (var olmayan bir sayfa istemek gibi), 5xx ise sunucunun geçerli bir isteği yerine getiremediği anlamına gelir.

401 ile 403 arasındaki fark nedir?

401 Unauthorized, kimliğinizi doğrulamadığınız (veya kimlik bilgilerinizin geçersiz olduğu) anlamına gelir — sunucu kim olduğunuzu bilmez. 403 Forbidden ise sunucunun kim olduğunuzu bildiği ancak kaynağa erişim izniniz olmadığı anlamına gelir.

Neden bazen açıkça yüklenemeyen bir sayfa için 200 görüyorum?

Bu genellikle sunucunun geçerli bir HTTP yanıtı döndürdüğü (dolayısıyla 200 OK), ancak bu yanıtın uygulama düzeyindeki içeriğinin bir hatayı tanımladığı anlamına gelir — hata ayrıntılarını durum kodu yerine yanıt gövdesine koyan API'lerde yaygın bir kalıptır.

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

301 Moved Permanently, tarayıcılara ve arama motorlarına kayıtlarını güncellemelerini ve bundan sonra yeni URL'yi kullanmalarını söyler. 302 Found ise geçici bir yönlendirmeyi işaret eder — gelecekteki istekler için orijinal URL kullanılmaya devam etmelidir.