HTTP durum kodları

Durum kodu, sunucunun bir isteğin sonucunu özetlemesidir ve bir programın gövdeyi okumadan buna göre davranabileceği biçimdedir. İlk hane sınıfı belirtir: 2xx başarılı, 3xx başka yere bak, 4xx istek hatalı, 5xx sunucu başarısız oldu. Kalan haneler o sınıf içindeki anlamı daraltır.

Nasıl çalışır

İstemciler önce sınıfa, sonra tam koda göre dallanır: 2xx işlenir, 3xx takip edilir, 4xx isteği oluşturan tarafa bildirilir, 5xx ise istek idempotent ise yeniden denenebilir. Belirli kodlar da belirli talimatlar taşır — 401 kimliğini doğrula, 429 yavaşla, 412 yazmadan önce yeniden oku demektir.

Yaygın yanılgı

Asıl cevabın gövde, kodun ise süs olduğu sanılır. Önbellekler, proxy’ler, yeniden deneme mantığı, izleme araçları ve tarayıcılar gövdeyi okumadan durum satırına göre hareket eder; {"error": …} ile 200 dönen bir API bunların hiçbirine görünmez, hata oranı da öyle.

Burada deneyin

Durum kodu dizini, bu oyun alanının döndüğü her kod için bir sayfaya ve o kodu üreten uç noktalara bağlanır. GET /faults/v1/status/{code} ise 200 ile 599 arasındaki herhangi bir kodu istek üzerine döndürür.

İlgili

Kaynaklar

Diğer terimler

REST API — Bir sistemi adreslenebilir kaynaklar olarak modelleyen ve onları standart HTTP metotlarıyla değiştiren API.
API uç noktası (endpoint) — Bir URL ile bir HTTP metodunun birleşimi — bir istemcinin çağırabileceği en küçük API birimi.
Sorgu parametreleri — URL’deki ? işaretinden sonra gelen, bir uç noktanın döndürdüğünü filtrelemek, sıralamak ya da sayfalamak için kullanılan anahtar=değer çiftleri.
Yollar — Bir URL yolunun, /orders/42’deki 42 gibi, belirli bir kaynağı tanımlayan değişken parçası.
HTTP — Her istek ve yanıtla birlikte, gövdeden ayrı olarak gönderilen ad–değer üst verisi.
İçerik uzlaşımı — İstemci ile sunucunun yanıtın biçiminde, ayrı adresler üzerinden değil başlıklarla anlaşması.

Bu sayfayı İngilizce okuyun

Tüm sözlük maddeleri · Test teknikleri · 39 mock REST API’nin tamamı

Son güncelleme 16 Ekim 2026