HTTP Durum Kodları

HTTP Durum Kodu Referansı

HTTP durum kodları, bir sunucunun istemci isteğine yanıt olarak döndürdüğü üç basamaklı sayılardır. İlk basamak kategoriyi tanımlar: 1xx bilgilendirme, 2xx başarı, 3xx yönlendirme, 4xx istemci hataları ve 5xx sunucu hataları. Her web geliştiricisi ve API tüketicisi bu kodlarla günlük olarak karşılaşır ve ne anlama geldiklerini bilmek hata ayıklama süresini kısaltır.

HTTP Durum Kodu Nedir?

HTTP durum kodu, bir sunucunun istek aldıktan sonra istemciye (tarayıcı, mobil uygulama, API istemcisi) gönderdiği üç basamaklı bir sayıdır. İstemciye ne olduğunu söyler: istek başarılı mı oldu, başarısız mı oldu yoksa daha fazla bilgi mi gerektiriyor? Durum kodları HTTP protokol spesifikasyonunun (RFC 9110) bir parçasıdır ve tüm web sunucuları ve API’ler arasında standarttır. Bir web sitesini açtığında, tarayıcın sayfa içeriğiyle birlikte bir durum kodu (genellikle 200 OK) alır. Bir API çağrısı yaptığında ve 404 aldığında, bu istenen kaynağın mevcut olmadığı anlamına gelir. Durum kodlarını anlamak, web uygulamalarını hata ayıklamak, API’ler oluşturmak ve herhangi bir tabanlı servis ile çalışmak için temeldir.

Nasıl Kullanılır

1. Numaraya veya ada göre arayın. Listeyi filtrelemek için “404” gibi bir durum kodu veya “redirect” gibi bir anahtar kelime yazın
2. Kategoriye göre filtreleyin. Yalnızca bilgilendirme, başarı, yönlendirme, istemci hatası veya sunucu hatası kodlarını görmek için bir kategori sekmesine tıklayın
3. Bir kodu genişletin. Ayrıntılı açıklamayı görmek için herhangi bir durum kodu satırına tıklayın
4. Kopyalayın. Kodu ve adı panonuza kopyalamak için kopyalama butonuna tıklayın

HTTP Durum Kodu Kategorilerini Anlamak

1xx Bilgilendirme

Geçici yanıtlar. Sunucu isteği almıştır ve istemci devam etmeli veya beklemelidir. Bunları doğrudan nadiren görürsünüz. En pratik olanı, HTTP’nin WebSocket’e yükseltilme şekli olan 101 Switching Protocols’tür.

2xx Başarı

İstek alınmış, anlaşılmış ve kabul edilmiştir. 200 OK standart başarı yanıtıdır. 201 Created, yeni bir kaynak oluşturan POST için doğru yanıttır. 204 No Content, geri gönderilecek bir şey olmadığında başarılı bir DELETE için döndürülür. Doğru 2xx kodunu kullanmak API’leri kendi kendini belgeleyen hale getirir.

3xx Yönlendirme

İsteği tamamlamak için genellikle bir Location başlığını takip ederek daha fazla işlem gerekir. 301 ve 308 kalıcı yönlendirmelerdir (arama motorları sıralamayı aktarır). 302 ve 307 geçicidir (arama motorları orijinal URL’yi korur). Eşleştirilmiş kodlar arasındaki fark: 307/308 yöntem korumasını garanti ederken, 301/302 tarayıcıların POST’u GET olarak değiştirmesine izin verir.

4xx İstemci Hatası

İstek hatalı sözdizimi içerir veya yerine getirilemez. Bunlar arayanın hatasıdır. 400 Bad Request hatalı girdiyi kapsar. 401 eksik veya geçersiz kimlik bilgileri içindir. 403, geçerli kimlik bilgileri için izin eksikliğidir. 404 evrensel “bulunamadı” kodudur. 422, geçerli sözdizimi ancak iş kuralı doğrulaması başarısız olduğunda kullanılır (REST API’lerinde yaygındır). 429 hız sınırlamasıdır.

5xx Sunucu Hatası

Sunucu geçerli bir isteği yerine getirememiştir. Bunlar sunucunun hatasıdır. 500 genel amaçlı hatadır. 502 ve 504 proxy/ağ geçidi sorunlarına işaret eder (proxy arkasındaki uygulama sunucusu çöktü veya zaman aşımına uğradı). 503, sunucunun geçici olarak aşırı yüklendiği veya bakımda olduğu anlamına gelir.

API entegrasyonlarında hata ayıklarken durum kodunun 4xx (isteğinizi düzeltin) mu yoksa 5xx (sunucuyu kontrol edin) mi olduğunu kontrol ederek başlayın. 401 ile dönen bir JWT’yi incelemeniz mi gerekiyor? JWT Çözücü’yü deneyin. API istekleri için URL’ler mi oluşturuyorsunuz? URL Kodlayıcı yüzde kodlamasını doğru şekilde halleder.