HTTP Üstbilgileri

HTTP başlıkları, her HTTP isteğine ve yanıtına eklenen ve gönderilen gerçek içerikten ayrı olarak, isteğin kendisi hakkında bilgi taşıyan anahtar-değer çiftleridir; örneğin kimin istekte bulunduğu, verilerin hangi biçimde beklendiği ve verilerin nasıl işlenmesi gerektiği gibi. Feed yönetiminde, başlıklar bir Feed platformunun bir API'ye kimlik doğrulaması yapmasını, XML yerine JSON gönderdiğini veya beklediğini belirtmesini ve önbellekleme veya sıkıştırma talimatlarını iletmesini sağlar; tüm bu bilgiler, istek gövdesindeki gerçek ürün verilerini karıştırmaz.

Katalog Yönetimi İçin Neden Önemli?

Bir Feed platformu ile bir kanal (Google Merchant Center, Meta Catalog, perakendecinin kendi ERP sistemi) arasındaki her otomatik bağlantı, başlıkların görevlerini doğru şekilde yerine getirmesine bağlıdır. Authorization Geçersiz veya süresi dolmuş bir belirteç içeren bir başlık, aksi takdirde mükemmel şekilde biçimlendirilmiş bir Feed gönderiminin tamamen başarısız olmasına neden olur ve eksik veya yanlış bir belirteç de sorun yaratır. Content-Type Başlıklar, bir kanalın JSON yükünü düz metin olarak veya tam tersi şekilde yanlış yorumlamasına ve yüklemeyi sessizce bozmasına neden olabilir. Başlıklar ayrıca hız sınırlama ve yeniden deneme mantığının da bulunduğu yerdir: birçok API şu gibi başlıklar döndürür: Retry-After or X-RateLimit-Remaining Bir Feed platformuna, kısıtlanmadan önce kaç istek daha yapabileceğini bildirmek için kullanılır; bu, dakikada istek sayısını sınırlayan bir kanala karşı on binlerce SKU senkronize edilirken önemlidir. Başarısız bir Feed senkronizasyonunun hata ayıklaması genellikle önce başlıkları incelemeye dayanır, çünkü bir isteğin gövdesi mükemmel derecede doğru görünürken, bir başlık sessizce reddedilmeye neden olabilir.

Nasıl Çalışır?

Başlıklar, HTTP isteğinin veya yanıtının en üstünde, URL ve gövdeden ayrı olarak düz metin satırları olarak gönderilir. Tipik bir RSS API isteği şunları içerebilir: Authorization: Bearer <token> Arayanın kimliğini doğrulamak için, Content-Type: application/json Gönderilen verilerin formatını belirtmek için ve Accept: application/json Beklenen geri dönüş formatını belirtmek için. sorgu parametresi ya da diğeri URL parametreleri Adres çubuğunda doğrudan görünen başlıkların aksine, başlıklar URL'nin kendisinde görünmezdir; bu da onları, tarayıcı geçmişinde veya sunucu günlüklerinde görünmemesi gereken kimlik doğrulama belirteçleri gibi hassas bilgiler için doğru yer haline getirir. Bazı başlıklar istemci veya sunucu tarafından otomatik olarak ayarlanır (örneğin Date or Content-LengthDiğerleri -özellikle kimlik doğrulama ve özel izleme başlıkları- entegrasyonu oluşturan kişi tarafından açıkça yapılandırılırken, diğerleri bu şekilde belirlenir.

Örnek E-posta

<!-- Representative HTTP request headers sent when a feed platform
     pushes a product update to a channel's API -->
<item>
  <g:id>SKU-40217</g:id>
  <title>Ceramic Plant Pot - 8 inch, Terracotta</title>
  <g:price>18.50 USD</g:price>
  <sync_request_headers>
    Authorization: Bearer eyJhbGciOi...
    Content-Type: application/json
    Accept: application/json
  </sync_request_headers>
</item>

MKS sync_request_headers Yukarıdaki blok gerçek bir Feed özelliği değil, ancak bu öğenin verilerinin, toplu dosya yüklemesi yerine bir API çağrısı yoluyla bir kanala her gönderildiğinde eşlik eden başlık meta verilerini göstermektedir.

Ilgili kavramlar

Başlıklar, istekle birlikte gelen sorgu parametreleri ve URL parametreleriyle birlikte çalışır, ancak onlardan ayrıdır; temel fark görünürlüktür: başlıklar URL'nin dışında kalır, bu nedenle kimlik doğrulama belirteçleri bir bağlantıya eklenmek yerine orada bulunur. Üçü birlikte, bir kanalın API'sinin aslında ne aldığını tanımlar ve bunlardan herhangi birinin yanlış olması, bir yayın senkronizasyonunun sessizce başarısız olmasının en yaygın nedenlerinden biridir.