Nagłówki HTTP

Nagłówki HTTP to pary klucz-wartość dołączone do każdego żądania i odpowiedzi HTTP, które zawierają informacje o samym żądaniu – niezależnie od faktycznej wysyłanej treści – takie jak osoba pytająca, oczekiwany format danych i sposób ich obsługi. W zarządzaniu kanałami informacyjnymi nagłówki umożliwiają platformie uwierzytelnianie się w interfejsie API, określanie, że wysyła lub oczekuje danych w formacie JSON, a nie XML, oraz przekazywanie instrukcji buforowania lub kompresji, a wszystko to bez zaśmiecania danych o produktach w treści żądania.

Dlaczego ma to znaczenie dla zarządzania paszą

Każde zautomatyzowane połączenie między platformą feedową a kanałem — Google Merchant Center, Meta Catalog, własnym systemem ERP sprzedawcy — zależy od prawidłowego wykonywania swojej funkcji przez nagłówki. Authorization nagłówek zawierający nieprawidłowy lub wygasły token spowoduje, że przesłanie kanału w innym przypadku idealnie sformatowanego zakończy się niepowodzeniem, a brakujący lub nieprawidłowy token Content-Type Nagłówek może spowodować, że kanał błędnie zinterpretuje dane JSON jako zwykły tekst lub odwrotnie, po cichu uszkadzając przesyłanie. Nagłówki to również miejsce, w którym znajduje się logika ograniczania przepustowości i ponawiania prób: wiele interfejsów API zwraca nagłówki takie jak Retry-After or X-RateLimit-Remaining Aby poinformować platformę feedową, ile jeszcze żądań może wysłać, zanim zostanie ograniczona, co ma znaczenie przy synchronizacji dziesiątek tysięcy jednostek SKU z kanałem, który ogranicza liczbę żądań na minutę. Debugowanie nieudanej synchronizacji feedu często sprowadza się do sprawdzenia najpierw nagłówków, ponieważ treść żądania może wyglądać idealnie poprawnie, podczas gdy nagłówek po cichu powoduje odrzucenie.

Jak to działa

Nagłówki są wysyłane jako zwykłe wiersze tekstu na górze żądania lub odpowiedzi HTTP, oddzielnie od adresu URL i treści. Typowe żądanie API kanału RSS może obejmować: Authorization: Bearer <token> aby potwierdzić tożsamość dzwoniącego, Content-Type: application/json aby zadeklarować format wysyłanych danych oraz Accept: application/json aby określić oczekiwany format. W przeciwieństwie do parametr zapytania lub inny Parametry adresu URL Nagłówki, które pojawiają się bezpośrednio w pasku adresu, są niewidoczne w samym adresie URL, co czyni je odpowiednim miejscem do przechowywania poufnych informacji, takich jak tokeny uwierzytelniające, które nie powinny pojawiać się w historii przeglądarki ani w logach serwera. Niektóre nagłówki są ustawiane automatycznie przez klienta lub serwer (np. Date or Content-Length), podczas gdy inne — szczególnie uwierzytelnianie i niestandardowe nagłówki śledzenia — są konfigurowane jawnie przez osobę, która tworzy integrację.

Przykład

<!-- 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>

sync_request_headers Blok powyżej nie jest prawdziwym atrybutem kanału, ale ilustruje metadane nagłówka, które towarzyszą danym tego elementu za każdym razem, gdy jest on przesyłany do kanału za pomocą wywołania API, a nie poprzez zbiorcze przesyłanie pliku.

Powiązane pojęcia

Nagłówki działają równolegle – ale niezależnie – z parametrami zapytania i parametrami adresu URL , które również są przesyłane wraz z żądaniem. Kluczową różnicą jest ich widoczność: nagłówki pozostają poza adresem URL, dlatego tokeny uwierzytelniające są tam przechowywane, a nie dołączane do linku. Wszystkie trzy elementy razem definiują, co faktycznie otrzymuje API kanału , a błąd w dowolnym z nich jest jedną z najczęstszych przyczyn nieudanej synchronizacji kanałów.