Site hata kodları nedir? Hangi kod ne anlama geliyor?

Anasayfa - Blog

Site hata kodları nedir? Hangi kod ne anlama geliyor?

Bir web sayfası açıldığında tarayıcı ile sunucu arasında HTTP isteği ve yanıtı gerçekleşir. Sunucunun döndürdüğü üç haneli durum kodu, isteğin başarıyla tamamlanıp tamamlanmadığını ve sonraki adımın ne olması gerektiğini bildirir. Bu kodlar yalnızca geliştiriciler için değildir; SEO, kullanıcı deneyimi, izleme ve güvenlik çalışmalarının da temel sinyalleridir.

HTTP durum kodu sınıfları

  • 1xx: İstek işlenmeye devam ediyor.
  • 2xx: İstek başarıyla tamamlandı.
  • 3xx: Kaynağa ulaşmak için yönlendirme veya ek işlem gerekiyor.
  • 4xx: İstek, adres, yetki veya hız sınırı gibi istemci taraflı bir sorun var.
  • 5xx: Sunucu isteği işlerken hata oluştu.

En sık görülen 2xx kodları

200 OK

İstek başarıyla işlendi ve içerik gönderildi. Normal bir web sayfasının beklenen yanıtıdır. Hata mesajı gösteren bir sayfanın 200 dönmesi doğru değildir; bu durum arama motorları tarafından “soft 404” olarak değerlendirilebilir.

201 Created

İstek sonucunda yeni bir kaynak oluşturulduğunu belirtir. API üzerinden kayıt ekleme gibi işlemlerde kullanılır.

204 No Content

İşlem başarılıdır ancak yanıtta içerik yoktur. Arka planda kaydetme veya silme gibi API işlemlerinde görülebilir.

Yönlendirme kodları: 3xx

301 Moved Permanently

Kaynağın kalıcı olarak yeni adrese taşındığını bildirir. Alan adı değişikliği, URL düzenlemesi veya eski sayfanın net bir karşılığı olduğunda kullanılır. Yönlendirme doğrudan nihai adrese gitmeli; uzun zincirlerden kaçınılmalıdır.

302 Found

Geçici yönlendirmedir. Kaynağın asıl adresinin korunması beklenir. Kalıcı taşınmada yanlışlıkla 302 kullanmak arama motorlarına belirsiz sinyal verebilir.

307 ve 308

307 geçici, 308 kalıcı yönlendirmedir. Bu kodlar HTTP metodunun ve istek gövdesinin korunmasını açık biçimde garanti eder; özellikle API ve form isteklerinde önemlidir.

İstemci hata kodları: 4xx

400 Bad Request

İstek biçimi hatalı veya işlenemeyecek durumdadır. Eksik API parametresi, bozuk JSON veya geçersiz veri örnek olabilir.

401 Unauthorized

İsmi “yetkisiz” gibi görünse de pratik anlamı kimlik doğrulamanın gerekli veya başarısız olmasıdır. Kullanıcı giriş yapmamış olabilir.

403 Forbidden

Sunucu isteği anlar fakat kaynağa erişime izin vermez. Kullanıcı kimliği bilinse bile rol veya dosya izni yetersiz olabilir.

404 Not Found

İstenen kaynak bulunamamıştır. Yanlış yazılmış adres, silinen içerik veya hatalı iç bağlantı nedeniyle oluşabilir. Özel 404 tasarımı kullanıcıya yol göstermeli ama sunucu yine gerçek 404 durumunu döndürmelidir.

410 Gone

Kaynağın kalıcı olarak kaldırıldığını ve yerine yönlendirme bulunmadığını daha açık biçimde belirtir. Her silinen sayfada zorunlu değildir; bilinçli ve kalıcı kaldırmalarda kullanılabilir.

429 Too Many Requests

Kullanıcı veya sistem kısa sürede izin verilenden fazla istek göndermiştir. API hız sınırı, giriş denemesi veya bot korumasında görülür. Uygun olduğunda Retry-After başlığı ile bekleme süresi bildirilebilir.

Sunucu hata kodları: 5xx

500 Internal Server Error

Sunucuda beklenmeyen genel hata oluşmuştur. Uygulama istisnası, yanlış yapılandırma veya dosya izni sorunları neden olabilir. Ayrıntılı hata ziyaretçiye gösterilmemeli, güvenli loglarda tutulmalıdır.

502 Bad Gateway

Proxy veya ağ geçidi, arka uç sunucudan geçerli yanıt alamamıştır. PHP-FPM, uygulama sunucusu veya upstream servis kesintileri tipik nedenlerdir.

503 Service Unavailable

Sunucu bakımda, aşırı yükte veya geçici olarak hizmet veremiyor olabilir. Geçici durumlarda Retry-After başlığı kullanılabilir. Planlı bakım sayfası 200 yerine 503 dönmelidir.

504 Gateway Timeout

Ağ geçidi arka uçtan zamanında yanıt alamamıştır. Uzun veritabanı sorguları, harici API gecikmeleri veya kapasite sorunu araştırılmalıdır.

SEO açısından doğru durum kodu neden önemlidir?

Arama motoru yalnızca ekrandaki metne değil HTTP yanıtına da bakar. Bulunamayan sayfanın 200 dönmesi soft 404, kalıcı taşınan sayfanın yönlendirilmemesi bağlantı değerinin ve kullanıcı trafiğinin kaybı, bütün eski adreslerin ana sayfaya yönlendirilmesi ise alakasız yönlendirme sorunu oluşturabilir.

Kontrol ve izleme yöntemleri

  • Tarayıcı geliştirici araçlarında Network sekmesini kullanın.
  • curl -I https://ornek.com/sayfa ile yanıt başlıklarını inceleyin.
  • Search Console sayfa dizine ekleme raporlarını takip edin.
  • Sunucu loglarında 404 ve 5xx artışları için alarm oluşturun.
  • Site içi bağlantıları düzenli olarak tarayın.

Sonuç

Durum kodları web sitesinin görünmeyen iletişim dilidir. Kullanıcıya doğru ekranı göstermek kadar sunucuya doğru kodu döndürmek de önemlidir. 4xx artışı bağlantı ve erişim sorunlarını, 5xx artışı ise altyapı veya uygulama problemlerini işaret eder; ikisi de düzenli izlenmelidir.

Resmî kaynak: MDN HTTP durum kodları referansı.

İçerik editörlüğü ve destek

Bu içerik İlter Web Tasarım editör ekibi tarafından bilgilendirme amacıyla hazırlanmıştır. Projenize özel değerlendirme için ekibimizle iletişime geçebilirsiniz.

Uzmanla Görüşün

Yorum Yapabilirsiniz.

E-posta mailiniz gizli kalacaktır.*

İyi görünüyor!
Lütfen isminizi giriniz.
İyi görünüyor!
Lütfen geçerli bir e-posta adresi girin.
İyi görünüyor!
Lütfen yorumunuzu giriniz.