HTTP Durum Kodları Nedir?
İngilizce: HTTP Status Codes
HTTP durum kodları, bir isteğin başarı, yönlendirme, istemci hatası veya sunucu hatasıyla sonuçlandığını gösteren 3 haneli yanıtlardır.
HTTP Durum Kodları Nedir?
HTTP durum kodları, sunucunun bir HTTP isteğini nasıl sonuçlandırdığını standart bir sayı ile anlatır. Tarayıcılar, API istemcileri, arama motorları ve izleme araçları bu kodlara bakarak sonraki adımı belirler.
Kodlar beş ana sınıfa ayrılır. 1xx bilgilendirme, 2xx başarı, 3xx yönlendirme, 4xx istemci tarafı hata, 5xx sunucu tarafı hata anlamına gelir. Örneğin 200 OK başarılı yanıtı, 201 Created yeni kaynak oluşturulduğunu, 301 Moved Permanently kalıcı yönlendirmeyi, 404 Not Found kaynağın bulunamadığını, 500 Internal Server Error ise sunucuda beklenmeyen hata olduğunu gösterir.
API ve Web Davranışında Rolü
Durum kodları sadece teknik detay değildir; ürün davranışını da etkiler. Bir ödeme API’si hatalı kart bilgisinde 400 ailesinden açık bir yanıt döndürmeli, stok yetersizliği gibi iş kuralı hatalarını belirsiz 500 yanıtına çevirmemelidir. Web sitelerinde 301 ve 308 yönlendirmeleri SEO geçişlerinde, 404 ve 410 kodları silinen içeriklerde, 503 kodu geçici bakım durumlarında kullanılır.
Dikkat Edilecek Noktalar
Her hata için 200 döndürmek izleme, önbellekleme ve istemci tarafı hata yönetimini bozar. Benzer şekilde her problemi 500 yapmak API kullanan ekiplerin doğru aksiyon almasını zorlaştırır. HTTP protokolünün semantiğine uygun kod seçimi, REST API tasarımında dokümantasyon kadar önemlidir.
İlgili Terimler
API hata yönetimi, başarısız istekleri doğru HTTP kodu, makine okunur hata alanları ve geliştiriciye yararlı mesajlarla döndürür.
HTTPHTTP, tarayıcılar, API istemcileri ve sunucular arasında istek-yanıt düzenini tanımlayan temel web iletişim protokolüdür.
REST APIREST API, HTTP yöntemleriyle kaynakları okuma ve değiştirme üzerine kurulu, entegrasyonlarda yaygın kullanılan web servis tasarımıdır.