HTTP Durum Kodları

Tüm HTTP durum kodları, anlamları ve ne zaman gönderilecekleri; numaraya, ifadeye veya açıklamaya göre aranabilir.

200

OK

İstek başarılı oldu ve yanıt gövdesi sonucu taşıyor. Başarılı bir GET, PUT veya POST için varsayılan yanıt.

201

Created

Yeni bir kaynak oluşturuldu. Location başlığı bu kaynağı göstermeli, gövde de genelde oluşturulan kaydı içerir.

204

No Content

Başarılı, ancak döndürülecek gövde yok. DELETE için yaygındır; istemci sonucu zaten biliyorsa PUT ve PATCH için de kullanılır.

301

Moved Permanently

Kaynak kalıcı olarak taşındı. Arama motorları sıralama sinyallerini yeni URL'ye aktarır; gerçek ve kalıcı taşımalarda kullanın.

302

Found

Kaynak geçici olarak başka bir yerde. Özgün URL dizinde kalır; bakım sayfalarına ve kısa ömürlü testlere uygundur.

304

Not Modified

Önbellekteki kopya hâlâ güncel, bu yüzden gövde gönderilmiyor. If-None-Match veya If-Modified-Since ile tetiklenir ve çok bant genişliği kazandırır.

307

Temporary Redirect

Özgün yöntemi ve gövdeyi koruyan geçici yönlendirme; birçok istemcinin sessizce GET'e çevirdiği 302'den farkı budur.

308

Permanent Redirect

Özgün yöntemi ve gövdeyi koruyan kalıcı yönlendirme. Taşınmış POST uç noktaları için güvenli kalıcı seçenektir.

400

Bad Request

Sunucu isteği anlayamadı. Genelde bozuk JSON, hatalı sorgu dizesi veya geçersiz bir başlıktır; iş kuralı hatası değildir.

401

Unauthorized

Kimlik doğrulama eksik ya da reddedildi. Adına rağmen bu kimlikle ilgilidir ve doğru şekilde doğrulanmak sorunu çözebilir.

403

Forbidden

Sunucu kim olduğunuzu anladı ve yine de reddediyor. 401'den farklı olarak aynı bilgilerle tekrar denemek işe yaramaz.

404

Not Found

Kaynak o URL'de yok. Ayrıca çağıranın bilmemesi gereken bir şeyin varlığını gizlemek için bilinçli olarak da kullanılır.

405

Method Not Allowed

URL var ama o HTTP yöntemi için değil; örneğin salt okunur bir uç noktaya POST. Yanıt, izin verilen yöntemleri listelemeli.

409

Conflict

İstek mevcut durumla çakışıyor; örneğin eski bir sürüme dayanan bir düzenleme ya da zaten var olan bir şeyi oluşturma girişimi.

413

Content Too Large

İstek gövdesi sunucunun işlemeye razı olduğundan büyük. Düşük limitli bir vekil arkasındaki dosya yüklemelerinde sık görülür.

415

Unsupported Media Type

Gövde, uç noktanın kabul etmediği bir biçimde; örneğin yalnızca JSON alan bir uç noktaya form verisi göndermek.

422

Unprocessable Content

Sözdizimi doğruydu ama içerik doğrulamayı geçemedi; örneğin zorunlu bir alan eksik. Form ve API doğrulama hataları için olağan seçim.

429

Too Many Requests

Çok kısa sürede çok fazla istek. Retry-After başlığı istemciye tekrar denemeden önce ne kadar bekleyeceğini söylemelidir.

500

Internal Server Error

Geçerli bir istek işlenirken sunucu içinde bir şey başarısız oldu. Daha özel bir kod yoksa kullanılan genel koddur ve logları kontrol etmek gerekir.

502

Bad Gateway

Bir vekil veya yük dengeleyici, arkadaki servisten geçersiz ya da boş yanıt aldı; genelde servis çökmüştür veya dinlemiyordur.

503

Service Unavailable

Servis aşırı yük veya bakım nedeniyle isteği geçici olarak karşılayamıyor. İstemcilerin makul şekilde geri çekilmesi için Retry-After ekleyin.

504

Gateway Timeout

Bir vekil arkadaki servisi bekledi ama zamanında yanıt gelmedi. Çökmeden çok yavaşlığa veya takılmaya işaret eder.

Durum Kodu Referansı Nasıl Kullanılır

1

Arayın veya filtreleyin

404 gibi bir numara, gateway gibi bir ifade ya da anlamdan bir kelime yazın. Ayrıca sınıfa göre filtreleyip yalnızca yönlendirmeleri, istemci hatalarını veya sunucu hatalarını görebilirsiniz.

2

Gerçekte ne demek olduğunu okuyun

Her kodun, sunucunun ne söylediğini ve ne zaman göndermeniz gerektiğini anlatan sade bir açıklaması var; sadece şartnamedeki tek kelimelik ifade değil.

3

Kodunuza kopyalayın

Kopyalama düğmesi kodu ve resmi ifadesini birlikte verir; bir yanıta, test doğrulamasına ya da dokümantasyona doğrudan yapıştırabilirsiniz.

Özellikler

1xx'ten 5xx'e tüm sınıfları kapsayan eksiksiz liste
Her kodun ne anlama geldiğine dair sade dilde açıklama
Kod, ifade ve anlam üzerinde anında arama
Durum sınıfına göre filtreleme veya yalnızca yaygın kodları gösterme
Sunucunun gönderdiği haliyle resmi ifadeler
Sınıfa göre renk kodlaması; başarı, yönlendirme ve hata ayrışır
Kod ve ifadeyi tek tıkla kopyalama
Ücretsiz referans, üyelik yok, çevrimdışı çalışır

Sık Sorulan Sorular

1xx bilgilendirme, 2xx isteğin başarılı olduğu, 3xx istemcinin başka bir yere gitmesi gerektiği, 4xx istemcinin hata yaptığı, 5xx ise geçerli bir isteği işlerken sunucunun başarısız olduğu anlamına gelir.

401, kimlik doğrulaması yapmadığınız veya bilgilerinizin kabul edilmediği anlamına gelir; doğrulama yapmak işe yarayabilir. 403 ise sunucunun kim olduğunuzu bildiği ve yine de reddettiği anlamına gelir; aynı kimlikle tekrar denemek işe yaramaz.

301 kalıcıdır ve arama motorlarına sıralama sinyallerini yeni adrese taşımasını söyler; gerçek taşımalarda bunu kullanın. 302 geçicidir ve özgün URL'yi dizinde bırakır; bakım sayfaları ile A/B testlerine uygundur.

Bir vekil sunucu veya yük dengeleyici uygulamanıza ulaşmış ama geçersiz ya da boş yanıt almıştır. Genelde arkadaki süreç çökmüş, belleği bitmiş veya vekilin beklediği portu dinlemiyordur.

502, arkadaki servisin geçersiz bir şey döndürdüğü anlamına gelir. 504 ise hiç zamanında yanıt vermediği. Birincisi çökme veya yanlış yapılandırmayı, ikincisi yavaşlık ya da takılmayı işaret eder.

Hayır. HTTP düzeyinde ne olduğunu durum koduyla söyleyin, ayrıntıyı gövdeye koyun. Hata nesnesiyle 200 döndürmek önbelleklemeyi, izlemeyi ve durumu kontrol eden tüm genel istemcileri bozar.

400, isteğin kendisinin bozuk olduğu anlamına gelir; örneğin geçersiz JSON. 422 ise sözdiziminin çözüldüğü ama içeriğin doğrulamayı geçemediği anlamına gelir; örneğin zorunlu bir alanın eksik olması.

Kahve makineleri hakkındaki bir 1 Nisan şakası şartnamesinden gelir ve kullanılabilir değil, ayrılmış durumdadır. Gerçek bir API'de göndermeyin; ama insanlar cidden arattığı için burada yer alıyor.

Özel Bir Araç veya Uygulamaya mı İhtiyacınız Var?

Üretim kalitesinde web uygulamaları, SaaS platformları ve geliştirici araçları oluşturuyoruz. Projeniz hakkında konuşalım.

veya ücretsiz görüşme ayarlayın