Hızlı, aranabilir HTTP durum kodları listesi
Bir tarayıcı, mobil uygulama veya arama motoru botu bir web sunucusuna her istek yaptığında, sunucu üç haneli bir sayıyla yanıt verir. Bu HTTP durum kodları istemciye tam olarak ne olduğunu açıklar: isteğin başarılı mı yoksa başarısız mı olduğunu, kimlik doğrulama gerektirip gerektirmediğini veya başka bir yere yönlendirilmesi gerekip gerekmediğini belirtir.
Bu araç, resmi RFC spesifikasyonlarına dayalı standart HTTP yanıt kodlarının eksiksiz ve aranabilir bir sözlüğünü sunar. Tüm liste doğrudan tarayıcınızda yerel olarak yüklenip filtrelendiği için arama işlemi anında gerçekleşir. 301 ile 302 arasındaki farka bakmak veya 422 hatasının ne anlama geldiğini öğrenmek için sayfanın yeniden yüklenmesini beklemenize gerek kalmaz.
HTTP yanıt kodlarının beş sınıfı
HTTP kodları, ilk rakamlarına göre belirlenen beş farklı sınıfa ayrılır. Bu kategorileri anlamak, web trafiği sorunlarını tespit etmenin en hızlı yoludur:
1xx (Bilgilendirici)
Bu kodlar, sunucunun isteği aldığını ve işleme devam ettiğini gösterir. Bunlar geçici yanıtlardır ve istemci nihai yanıtı beklemelidir. Örneğin, 100 Continue istemciye işleme devam etmesini ve istek gövdesini göndermesini söyler.
2xx (Başarılı)
Bir 2xx kodu, istemcinin isteğinin başarıyla alındığını, anlaşıldığını ve kabul edildiğini gösterir. En yaygını, başarılı bir HTTP isteğinin standart yanıtı olan 200 OK kodudur. Bir API üzerinden yeni bir kayıt oluşturduğunuzda 201 Created yanıtını görebilirsiniz.
3xx (Yönlendirme)
Bu kodlar, isteği tamamlamak için ek bir işlem yapılması gerektiğini belirtir. Bu genellikle istenen kaynağın taşındığı anlamına gelir. 301 Moved Permanently arama motorlarına bağlantılarını güncellemelerini söylerken, 302 Found geçici bir taşınmayı ifade eder.
4xx (İstemci Hatası)
4xx aralığındaki HTTP hata kodları, sorunun istemci tarafında olduğu anlamına gelir. İstek hatalı sözdizimi içerebilir, kimlik doğrulaması eksik olabilir veya var olmayan bir kaynağı talep edebilir. Bu hatalar, kullanıcılar URL'leri yanlış yazdığında veya API entegrasyonları hatalı formatta veri gönderdiğinde sıkça görülür.
5xx (Sunucu Hatası)
Bir 5xx kodu, sunucunun geçerli bir isteği yerine getiremediğini belirtir. İstemci her şeyi doğru yapmıştır ancak sunucu dahili bir sorunla karşılaşmış, çökmüş veya o an için aşırı yüklenmiş olabilir.
Bilmeniz gereken yaygın HTTP hata kodları
Onlarca kod olsa da, bir geliştirici veya web yöneticisi olarak karşılaşacağınız hataların büyük çoğunluğunu sadece birkaçı oluşturur:
404 durum kodu (Bulunamadı)
İnternetteki belki de en bilinen hata olan 404 durum kodu, sunucunun istenen kaynağı bulamadığı anlamına gelir. Kırık bağlantılar kullanıcıları rahatsız edip tarama bütçesini boşa harcadığından, 404 hatalarını izlemek web sitesi sahipleri için SEO açısından kritik öneme sahiptir.
400 Bad Request
Sunucu; hatalı istek sözdizimi veya geçersiz yönlendirme gibi bir istemci hatası nedeniyle isteği işleyemez. API'ler, gerekli bir parametre eksik olduğunda sıklıkla bu hatayı döndürür.
401 Unauthorized & 403 Forbidden
Her ikisi de erişimle ilgilidir. Bir 401 Unauthorized, istemcinin istenen yanıtı alabilmesi için kimliğini doğrulaması gerektiği anlamına gelir (ör. eksik API anahtarı). 403 Forbidden ise istemcinin kimliğinin bilindiği ancak kaynağa erişmek için gerekli izinlere sahip olmadığı anlamına gelir.
500 Internal Server Error
Bu, sunucu tarafındaki çökmeleri ifade eden genel bir hata kodudur. Sunucunun, isteği yerine getirmesini engelleyen beklenmedik bir durumla karşılaştığı anlamına gelir. Bir 500 hatası aldığınızda, asıl nedeni bulmak için genellikle sunucunun uygulama loglarını kontrol etmeniz gerekir.
502 Bad Gateway & 503 Service Unavailable502 Bad Gateway, proxy görevi gören bir sunucunun (Nginx veya yük dengeleyici gibi) üst sunucudan geçersiz bir yanıt alması durumunda ortaya çıkar. 503 Service Unavailable ise sunucunun genellikle aşırı yüklenme veya bakım çalışması nedeniyle şu anda isteği karşılayamadığı anlamına gelir.
API geliştirme için en iyi uygulamalar
Bir REST API geliştirirken doğru HTTP durum kodlarını döndürmek, iyi bir geliştirici deneyimi için çok önemlidir. Gerçekte bir hata oluştuğunda 200 OK döndürmek (genellikle hataları "yutmak" olarak adlandırılır), istemcileri isteklerinin gerçekten başarılı olup olmadığını anlamak için yanıt gövdesini manuel olarak ayrıştırmaya zorlar.
Anlamsal olarak en doğru kodu seçmek için bu referansı kullanın. Örneğin, bir kullanıcı hız sınırına takıldığında 429 Too Many Requests veya JSON verisi geçerli olduğu halde iş mantığı doğrulamasından geçemediğinde 422 Unprocessable Content kullanın.
Sunucu yönlendirme sorunlarını araştırıyorsanız, alan adı kayıtlarını doğrulamak için DNS Sorgulama aracımızı veya sunucunuza istek yapan istemcileri anlamak için User-Agent Ayrıştırıcı aracımızı faydalı bulabilirsiniz. 404 hatalarını önlemek amacıyla arama motorlarının sitenizi nasıl taradığını yönetmek istiyorsanız, Robots.txt Oluşturucu aracını deneyin.