HTTP durum kodları
Bir HTTP yanıtı üç haneli bir kodla ve kısa bir neden ifadesiyle başlar. İlk rakam tüm özeti: 1xx geçicidir, 2xx başarısız, 3xx başka bir yere işaret eder, 4xx isteği suçlar, 5xx sunucuyu suçlar. Bunu hatırlarsan, hiç görmediğin bir günlüğü okuyabilirsin.
Buradaki neden ifadeleri RFC'lerden olanları İngilizce olup, çünkü telden geçer — bir sunucu "Not Found" gönderir, bunun bir çevirisini değil — ve bir günlükte aradığınız bir ifade gerçekten gönderilen baytlarla eşleşmesi gerekir.
Gerçek sorun oluşturan ayrımlar sınıflar arasında değil sınıf içindedir: 401 vs 403, 301 vs 308 ve 502 vs 503 her biri sonra ne yapılacağı hakkında farklı bir soruya cevap verir ve her biri rutinli olarak diğeri için kullanılır.
1xx — Bilgi
3Geçici: yanıt son değildir ve başka biri takip eder.
| Kod | Neden ifadesi | Ne anlama gelir |
|---|---|---|
| 100 | Continue | Başlıklar alındı, gövde göndermeye devam edin. |
| 101 | Switching Protocols | Protokolleri değiştirme — WebSocket el sıkışması. |
| 103 | Early Hints | Erken ipuçları: gerçek yanıt hazırlanırken bu kaynakları önyükleyin. |
2xx — Başarı
5İstek alındı, anlaşıldı ve kabul edildi.
| Kod | Neden ifadesi | Ne anlama gelir |
|---|---|---|
| 200 | OK | Başarı, gövdeli. |
| 201 | Created | Oluşturuldu.Yeni kaynağa işaret eden bir Konum başlığı taşımalıdır. |
| 202 | Accepted | İşleme için kabul edildi, henüz olmadı. |
| 204 | No Content | Başarı ve kasıtlı olarak gövde yok.DELETE'ye doğru yanıt veya döndürecek bir şey olmadan kaydetme. |
| 206 | Partial Content | Kalıcı olarak taşındı. Bağlantılarınızı güncelleyin; önbellekler bunu sonsuza kadar tutabilir. |
3xx — Yönlendirme
6Kaynak başka yerdedir, ya da önbelleğe alınmış kopyanız hala iyidir.
| Kod | Neden ifadesi | Ne anlama gelir |
|---|---|---|
| 301 | Moved Permanently | Kalıcı olarak taşındı. Bağlantılarınızı güncelleyin; önbellekler bunu sonsuza dek tutabilir. |
| 302 | Found | Bulundu — geçici yönlendirme.Geniş bir şekilde GET'e yöntemi değiştirme olarak uygulanmış olup, 307 bunu düzeltir. |
| 303 | See Other | Başka bakın: GET ile sonucu getiriniz. Bir form POST'tan sonra yönlendirme. |
| 304 | Not Modified | Değiştirilmedi — önbelleğe alınmış kopyanız güncel. Gövde olmadan gönderilen. |
| 307 | Temporary Redirect | Geçici yönlendirme, yöntem ve gövde korunmuş. |
| 308 | Permanent Redirect | Kalıcı yönlendirme, yöntem ve gövde korunmuş. |
4xx — İstemci hatası
14İstek sorundur. Değişmeden yineleme tekrar başarısız olur.
| Kod | Neden ifadesi | Ne anlama gelir |
|---|---|---|
| 400 | Bad Request | Sunucu isteği hiç ayrıştıramadı. |
| 401 | Unauthorized | Kimliği doğrulanmamış — sunucu kim olduğunuzu bilmiyor.Unauthorized adlandırılmış, ancak kimliği doğrulanmamış anlamına gelir. WWW-Authenticate içermeli. |
| 403 | Forbidden | Kimliği doğrulanmış ve hala izin verilmedi. Daha iyi kimlik bilgileri yardımcı olmayacaktır. |
| 404 | Not Found | Böyle bir kaynak yok ve sunucu orada hiç olup olmadığını söylemeyecektir. |
| 405 | Method Not Allowed | Bu URL için yanlış yöntem.Çalışanları bir İzin Ver başlığında listelemeli. |
| 406 | Not Acceptable | Hiçbir şey Kabul başlığınız alacak bir biçimde yok. |
| 409 | Conflict | Geçerli durumla çakışır — güncel olmayan bir sürüme karşı bir düzenleme. |
| 410 | Gone | Gitmiş: var oldu ve kasıtlı olarak kaldırıldı. 404'ten daha güçlü. |
| 413 | Content Too Large | Gövde sunucunun kabul ettiğinden daha büyüktür. |
| 415 | Unsupported Media Type | Sunucu bu Content-Type'ı işlemez. |
| 418 | I'm a teapot | Ben bir çaydanlığım. 1998 Nisan Aptalları şakası, kalıcı olarak ayrılmış. |
| 422 | Unprocessable Content | Doğru ayrıştırılmış, içerik geçersiz — eksik alan, kötü değer. |
| 429 | Too Many Requests | Oran sınırlı.Yeniden denemeden önce Retry-After bulun ve üstel olarak geri çekilin. |
| 451 | Unavailable For Legal Reasons | Yasal nedenler için engellendi. Sayı Fahrenheit 451'e bir işarettir. |
5xx — Sunucu hatası
6İstek iyiye varolabilir. Bunlar yeniden denemeye değenleridir.
| Kod | Neden ifadesi | Ne anlama gelir |
|---|---|---|
| 500 | Internal Server Error | Sunucuda işlenmemiş bir hata. Tarafınızda düzeltecek bir şey yok. |
| 501 | Not Implemented | Sunucu bu yöntemi hiç uygulamaz. |
| 502 | Bad Gateway | Bir vekil yukarı akış sunucusuna ulaştı ve kullanılamaz bir şey geri aldı. |
| 503 | Service Unavailable | Kasıtlı olarak hizmet vermiyor — aşırı yüklü veya bakım yapılıyor.Retry-After taşıması gereken durum. |
| 504 | Gateway Timeout | Bir vekil yukarı akış sunucusu için beklemekten vazgeçti. |
| 505 | HTTP Version Not Supported | İstekteki HTTP sürümü desteklenmez. |
FAQ
401 ile 403 arasındaki fark nedir?
401 Unauthorized istek kimliği doğrulanmadığı anlamına gelir — sunucu kim olduğunuzu bilmez ve doğru bir 401 bunu kanıtlamak için nasıl yapılacağını söyleyen bir WWW-Authenticate başlığı içerir. 403 Forbidden tam olarak kim olduğunuzu bilip yine de sahip olmayabileceğiniz anlamına gelir. Aynı kimlik için daha iyi kimlik bilgileriyle 403'ü yeniden denemek yardımcı olmayacaktır.
Yönlendirme için 301 veya 308'i kullanmalı mıyım?
308 yöntem önemsiyorsa. Tarihsel olarak 301 ve 302 yaygın olarak "yönlendir ve GET'e geç" olarak uygulanmıştır, bu sessizce bir POST'u GET'e dönüştürür. 307 ve 308, yöntem ve gövdenin korunduğunu vaat etmek için tanıtıldı. Yalnızca getirilen bir sayfanın kalıcı bir hareketinde, 301 en iyi anlaşılan seçim kalır.
422 ne anlama gelir ki 400 yoktur?
400 Bad Request sunucunun isteği hiç anlayamadığı anlamına gelir — hatalı JSON, kırık başlık. 422 Unprocessable Content yine de ayrıştırıldığı anlamına gelir ve içerik yine de yanlış olup: doğru biçimlenmiş gövde eksik zorunlu alan veya geçmiş bir tarihle. Bölünme yararlıdır çünkü istemcinin düzeltmesi her durumda farklıdır.
418 gerçek bir durum kodudur mu?
Kayıtlı olması bakımından gerçektir ve her HTTP kütüphanesi bunu bilir ve 1998 Nisan Aptalları Hyper Text Coffee Pot Kontrol Protokolü'nden gelmesi bakımından bir şakadır. Sayıyı pratik kullanım için talep etme girişimleri reddedildi, bu nedenle çaydanlık için kalıcı olarak ayrılmıştır.
503, 502'den neden farklıdır?
502 Bad Gateway, bir vekil yukarı akış sunucusuna ulaştığı ve kullanılamaz bir şey geri aldığı anlamına gelir. 503 Service Unavailable sunucunun kendisinin şu anda bilerek hizmet vermiyor olduğu anlamına gelir — aşırı yüklü veya bakım yapılıyor — ve Retry-After başlığını taşıyan biri olup, çünkü kurtarılması beklenen birdir.