Durum kodları · 1xx–5xx
Durum kodları atlası: doğru yanıtı seçmek
1xx–5xx ailelerini, tek tek kodları ve bir API kararının sonuçlarını birlikte öğren.
Kavramı anlayalım
Durum kodu yalnız ekrana basılan bir sayı değildir; tarayıcı, cache, proxy ve istemci bu sayıyla sonraki davranışını seçer. 2xx isteğin başarılı biçimde ele alındığını, 3xx yönlendirme veya başka bir işlem gerektiğini, 4xx isteğe ilişkin bir sorun olduğunu, 5xx sunucu tarafındaki başarısızlığı anlatır. 1xx bir ara yanıttır. “4xx her zaman kullanıcının suçu” veya “5xx her zaman yeniden denenir” gibi genellemeler doğru değildir.
Karar verirken dört soru sor: İstek anlaşıldı mı? Kimlik ve yetki uygun mu? İşlem tamamlandı mı? Yanıt başka bir katmanın sonucunu mu taşıyor? Kaynak oluşturmak 201, kuyruğa kabul etmek 202, tamamlanan ama içerik döndürmeyen işlem 204 olabilir. 200 altında her hatayı gizlemek, istemcinin hata yönetimini ve izlemeyi bozar. Kod ile Problem Details gövdesindeki status aynı kalmalıdır.
Aşağıdaki atlas kayıtlı kodları aile, sayı ve açıklama üzerinden aramana izin verir. WebDAV gibi uzantılar ayrıca belirtilir. Kullanılmayan, tarihsel veya geçici kodları normal API önerisiyle karıştırma; geçici kayıtlar zamanla değişebilir. Kod seçmek tek başına yeterli değildir: 401 challenge, 405 Allow, 201 Location ve 429/503 Retry-After gibi alanların anlamını da düşün. Şimdi senaryoyu okuyup karar ver; sonra ilgili aile dersinde ayrıntıları çalış.
API sözleşmesini, frontend hata akışını ve alarm kurallarını birlikte tasarlarken.
Fetch yalnız 4xx/5xx geldiği için promise reddetmez; response.ok veya status kontrol edilmelidir.
BAŞVURU MASASI
Durum kodunu bul. Anlamını öğren.
Kodları açarak açıklamasını ve ilgili derse bağlantısını gör. Tüm kayıtlar aynı kullanım önerisi değildir; uzantılar ve tarihsel kodlar etiketlidir.
64 / 64 kayıt
100ContinueProtokol
Gövde gönderimine devam edilebilir; son yanıt henüz gelmedi.
İlgili dersi çalış101Switching ProtocolsProtokol
HTTP/1.1 protokol değişimi kabul edildi; klasik WebSocket örneğini düşün.
İlgili dersi çalış102ProcessingÖzel uzantı
WebDAV kökenli ara işleme bildirimi; son başarı değildir.
İlgili dersi çalış103Early HintsProtokol
Son yanıt hazırlanırken kaynak ipuçları gelir; sonucu garanti etmez.
İlgili dersi çalış104Upload Resumption SupportedGeçici kayıt
Geçici resumable upload kaydı; geçerliliğini registry’de kontrol et.
2 Ekim 2026’da kontrol edilen kayıtta bitiş: 13 Kasım 2026. Deneysel desteği veya bu tarihi kalıcı standart sayma; güncel IANA kaydını kontrol et.
İlgili dersi çalış200OKProtokol
İstek başarılı işlendi; gövdenin anlamı methoda göre değişir.
İlgili dersi çalış201CreatedProtokol
Yeni kaynak oluşturuldu; birincil kaynağı Location veya hedef URI tanımlar.
İlgili dersi çalış202AcceptedProtokol
İş kabul edildi ama tamamlanmadı; sonradan başarısız olabilir.
İlgili dersi çalış203Non-Authoritative InformationProtokol
Ara katman kaynak temsili dönüştürdü; yalnız “güvenilmez bilgi” demek değildir.
İlgili dersi çalış204No ContentProtokol
İşlem başarılı, içerik yok; JSON parse etme.
İlgili dersi çalış205Reset ContentProtokol
İşlem başarılı; başlatan belge görünümü sıfırlansın. İçerik gönderilmez.
İlgili dersi çalış206Partial ContentProtokol
Bir veya daha çok byte aralığı döndü; uygun range metadata gerekir.
İlgili dersi çalış207Multi-StatusÖzel uzantı
WebDAV çoklu kaynak sonucu; gövdede ayrı durumlar bulunabilir.
İlgili dersi çalış208Already ReportedÖzel uzantı
WebDAV bağlamında aynı binding bilgisi yeniden listelenmez.
İlgili dersi çalış226IM UsedÖzel uzantı
GET sonucuna desteklenen instance manipulation uygulanmış özel delta yanıtı.
İlgili dersi çalış300Multiple ChoicesProtokol
Temsil seçenekleri mevcut; istemci seçimi gerekebilir.
İlgili dersi çalış301Moved PermanentlyProtokol
Kalıcı yeni URI; tarihsel POST→GET davranışını ve cache etkisini düşün.
İlgili dersi çalış302FoundProtokol
Geçici başka URI; methodun her istemcide korunacağını varsayma.
İlgili dersi çalış303See OtherProtokol
Sonucu başka kaynaktan GET/HEAD ile edin; form sonrası sık kullanılır.
İlgili dersi çalış304Not ModifiedProtokol
Koşullu GET/HEAD doğrulaması; yeni içerik yok, cache temsilini kullan.
İlgili dersi çalış305Use ProxyTarihsel / kullanma
Deprecated tarihsel proxy yönlendirmesi; yeni API tasarımında kullanma.
İlgili dersi çalış306UnusedKullanılmayan
Kullanılmayan ayrılmış kayıt; uygulama sonucu olarak seçme.
İlgili dersi çalış307Temporary RedirectProtokol
Geçici yönlendirme; method ve gövde korunur.
İlgili dersi çalış308Permanent RedirectProtokol
Kalıcı yönlendirme; method ve gövde korunur.
İlgili dersi çalış400Bad RequestProtokol
Bozuk sözdizimi veya genel geçersiz istek; düzeltilecek alanı güvenle açıkla.
İlgili dersi çalış401UnauthorizedProtokol
Geçerli authentication credential gerekiyor; WWW-Authenticate challenge zorunlu.
İlgili dersi çalış402Payment RequiredAyrılmış
Gelecekte kullanım için ayrılmış; evrensel ödeme standardı gibi anlatma.
İlgili dersi çalış403ForbiddenProtokol
Sunucu anladı ama reddetti; geçerli kimlikte yetersiz izin sık senaryo.
İlgili dersi çalış404Not FoundProtokol
Kaynak bulunamadı veya varlığı açıklanmıyor; authorization concealment olabilir.
İlgili dersi çalış405Method Not AllowedProtokol
Bu kaynak methodu desteklemiyor; Allow alanıyla izinli methodları bildir.
İlgili dersi çalış406Not AcceptableProtokol
Kabul edilebilir yanıt temsili üretilemiyor; Accept tercihlerini incele.
İlgili dersi çalış407Proxy Authentication RequiredProtokol
Forward proxy credential istiyor; Proxy-Authenticate gerekir.
İlgili dersi çalış408Request TimeoutProtokol
Sunucu isteği zamanında alamadı; her istemci timeout’unun adı değildir.
İlgili dersi çalış409ConflictProtokol
İstek kaynak durumuyla çatışıyor; değişiklik veya birleştirme gerekebilir.
İlgili dersi çalış410GoneProtokol
Kaynağın kullanılabilirliği kalıcı olarak sonlanmış biliniyor.
İlgili dersi çalış411Length RequiredProtokol
İstenen Content-Length bilgisi olmadan istek kabul edilmiyor.
İlgili dersi çalış412Precondition FailedProtokol
Gönderilen koşul sağlanmadı; eski If-Match tipik örnek.
İlgili dersi çalış413Content Too LargeProtokol
Gönderilen içerik boyut sınırını aşıyor; limit ve yükleme stratejisini düzelt.
İlgili dersi çalış414URI Too LongProtokol
URI fazla uzun; dev sorgu/filtreyi uygun sözleşmeyle yeniden tasarla.
İlgili dersi çalış415Unsupported Media TypeProtokol
Request içeriği tür/kodlama bakımından desteklenmiyor; 406 ile aynı değil.
İlgili dersi çalış416Range Not SatisfiableProtokol
İstenen aralık mevcut temsil için karşılanamıyor; toplam uzunluğu incele.
İlgili dersi çalış417Expectation FailedProtokol
Expect alanındaki beklenti sunucu zincirinde karşılanamıyor.
İlgili dersi çalış418UnusedKullanılmayan
IANA/RFC 9110’da kullanılmayan; tarihsel teapot mizahını normal API standardı sanma.
İlgili dersi çalış421Misdirected RequestProtokol
İstek bu hedef için yanıt üretemeyen sunucuya yönlendi.
İlgili dersi çalış422Unprocessable ContentProtokol
İçerik anlaşılır ama talimat işlenemiyor; validation sözleşmesini tutarlı kur.
İlgili dersi çalış423LockedÖzel uzantı
WebDAV kaynağı kilitli; sıradan account lockout kodu değildir.
İlgili dersi çalış424Failed DependencyÖzel uzantı
WebDAV işlemi bağımlı işlemin başarısızlığı nedeniyle çalışmadı.
İlgili dersi çalış425Too EarlyProtokol
Sunucu replay riski taşıyan erken veriyi işlemeyi istemiyor.
İlgili dersi çalış426Upgrade RequiredProtokol
İşlem için protokol yükseltme gerekiyor; Upgrade bilgisini düşün.
İlgili dersi çalış428Precondition RequiredProtokol
Sunucu koşullu istek istiyor; eksik önkoşul, başarısız karşılaştırma değil.
İlgili dersi çalış429Too Many RequestsProtokol
Rate limit aşıldı; kapsamı ve varsa Retry-After bilgisini değerlendir.
İlgili dersi çalış431Request Header Fields Too LargeProtokol
Tek header veya toplam alanlar çok büyük; şişmiş cookie’yi de incele.
İlgili dersi çalış451Unavailable For Legal ReasonsProtokol
Erişim yasal nedenle sınırlandı; teknik auth hatası değildir.
İlgili dersi çalış500Internal Server ErrorProtokol
Beklenmeyen sunucu koşulu; iç logla ilişkilendir, sırları ifşa etme.
İlgili dersi çalış501Not ImplementedProtokol
Gereken işlev sunucuda desteklenmiyor; 405 kaynak method kuralından farklı.
İlgili dersi çalış502Bad GatewayProtokol
Gateway upstream’den geçersiz yanıt aldı; hangi hop ürettiğini bul.
İlgili dersi çalış503Service UnavailableProtokol
Geçici kapasite/bakım olabilir; Retry-After replay güvenliği sağlamaz.
İlgili dersi çalış504Gateway TimeoutProtokol
Gateway upstream yanıtını zamanında alamadı; yan etki gerçekleşmiş olabilir.
İlgili dersi çalış505HTTP Version Not SupportedProtokol
Gerekli HTTP sürümü sunucu tarafından desteklenmiyor.
İlgili dersi çalış506Variant Also NegotiatesÖzel uzantı
Transparent negotiation yapılandırmasında özel seçim döngüsü hatası.
İlgili dersi çalış507Insufficient StorageÖzel uzantı
WebDAV bağlamında işlem için depolama yetersiz; özel uzantı kodu.
İlgili dersi çalış508Loop DetectedÖzel uzantı
WebDAV işleminde döngü bulundu; genel redirect-loop kodu değildir.
İlgili dersi çalış510Not ExtendedTarihsel / kullanma
Obsoleted tarihsel uzantı kaydı; yeni API için kullanma.
İlgili dersi çalış511Network Authentication RequiredProtokol
Ağ/captive portal erişimi kimlik istiyor; normal uygulama login’i değil.
İlgili dersi çalış419 ve 520 gibi framework/sağlayıcı kodları standart kayıtlarla karıştırılmamalıdır. 100–599 aralığındaki her sayı atanmış değildir. Bu atlas 2 Ekim 2026’da kontrol edildi.
Aynı konu. Üç farklı derinlik.
HTTP/1.1 201 Created
Location: /orders/42Sipariş gerçekten oluşturuldu; URI yeni kaynağı gösterir.
Bu sayfa dış sunuculara istek göndermez. HTTP mesajları temsili, HTTP/1.1 biçiminde okunabilir gösterimlerdir; HTTP/2 ve HTTP/3 wire formatı değildir. example.test ayrılmış öğretim alan adıdır. Komut ve JavaScript örneklerini yalnız kendi test ortamında uygula; gerçek token veya cookie yayımlama.
Önce kendin dene.
Bir rapor işi 30 saniye sürecek ve yalnız kuyruğa eklendi. 200 mü, 201 mi, 202 mi?
Çözümü ve açıklamasını göster
HTTP/1.1 202 Accepted
Location: /jobs/report-42202 kabulü anlatır; tamamlanmayı garanti etmez. Ayrı durum endpoint’iyle sonucu izle.