HTTP

Başlıklar bir mesajın içeriği dışındaki her şeyi taşır: kimin çağırdığını (Authorization), gövdenin biçimini (Content-Type), istemcinin hangi biçimi geri istediğini (Accept), ne kadar önbelleğe alınabileceğini (Cache-Control), hangi sürüm olduğunu (ETag) ve ne zaman yeniden denenmesi gerektiğini (Retry-After). Adlar büyük-küçük harf duyarsızdır, değerler metindir.

Nasıl çalışır

Bir istek ya da yanıt; bir başlangıç satırı, ardından her satırda bir başlık, sonra boş bir satır ve en sonda gövdeden oluşur. Aradaki sistemler gövdeye dokunmadan başlık okur ve ekler — proxy Via, yük dengeleyici X-Forwarded-For, CDN kendi önbellek durumunu ekler. API özelliği gibi görünen pek çok davranış aslında bir başlık geleneğidir.

Yaygın yanılgı

Gövde üzerinde doğrulama yapmanın yeterli olduğu sanılır. En sonuçlu hataların bazıları yalnızca başlıklarda yaşar: 201’den sonra eksik bir Location, kişiye özel bir yanıtın CDN’de önbelleğe alınmasına izin veren bir Cache-Control, JSON gövdeli bir yanıtta text/html Content-Type. Bunlar gövde üzerindeki her doğrulamadan geçer.

Burada deneyin

Dokümantasyon panelindeki her yanıt başlıklarını gövdenin yanında gösterir ve doğrulama dili onları headers.<ad> ile okur — GET /football/v1/standings üzerinde headers.etag exists deneyin.

İlgili

Kaynaklar

Diğer terimler

İçerik uzlaşımı — İstemci ile sunucunun yanıtın biçiminde, ayrı adresler üzerinden değil başlıklarla anlaşması.
ETag — Bir temsilin sürümünü belirten opak bir kimlik: hem yeniden göndermeyi önler hem de çakışan yazmaları yakalar.
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ı.

Bu sayfayı İngilizce okuyun

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

Son güncelleme 16 Ekim 2026