nieprawidłowy Content-Type

Nieprawidłowy Content-Type w odpowiedzi API uniemożliwia klientowi poprawne zinterpretowanie przesłanych danych.

Jak działa nagłówek Content-Type w odpowiedzi HTTP

Content-Type to nagłówek HTTP określający typ danych znajdujących się w treści odpowiedzi. Jego wartość składa się z typu MIME, a opcjonalnie także z parametrów opisujących sposób interpretacji danych. Przykładowo odpowiedź zawierająca dokument JSON powinna mieć nagłówek Content-Type: application/json, dokument HTML zwykle text/html, arkusz stylów CSS text/css, a obraz PNG image/png. Nagłówek nie zmienia zawartości odpowiedzi, lecz przekazuje klientowi informację, jak tę zawartość odczytać.

Nieprawidłowy Content-Type występuje wtedy, gdy wartość nagłówka nie odpowiada rzeczywistym danym albo gdy klient otrzymuje wartość nieobsługiwaną w danym przepływie. Przykładem jest zwrócenie obiektu JSON z nagłówkiem text/html lub wysłanie strony HTML z wartością application/json. Problem może dotyczyć także błędnego parametru, takiego jak niezgodne kodowanie znaków, albo braku nagłówka, gdy aplikacja wymaga jego obecności.

Dlaczego klient API odrzuca odpowiedź o złym typie

Klient API często wybiera sposób przetwarzania odpowiedzi na podstawie nagłówka Content-Type. Biblioteka HTTP lub kod aplikacji może wywołać parser JSON tylko dla odpowiedzi oznaczonej jako application/json. Jeżeli serwer zwróci JSON z typem text/html, klient może potraktować dane jako zwykły tekst albo zakończyć działanie błędem podczas automatycznej deserializacji. W odwrotnej sytuacji, gdy strona HTML zostanie oznaczona jako JSON, parser może zgłosić błąd składni, ponieważ pierwszy znak dokumentu nie rozpoczyna poprawnego obiektu lub tablicy JSON.

Nieprawidłowy Content-Type może pojawić się zarówno przy odpowiedzi poprawnej pod względem kodu HTTP, jak i przy błędzie. Serwer może zwrócić kod 200 OK, lecz dostarczyć stronę logowania, komunikat proxy albo stronę błędu zamiast oczekiwanego JSON-a. Z kolei odpowiedź 401 Unauthorized, 403 Forbidden lub 500 Internal Server Error może mieć własny format, który również musi być zgodny z deklarowanym typem. Sam kod statusu nie wystarcza więc do oceny, czy dane można bezpiecznie przekazać do parsera.

Ustalenie źródła rozbieżności między nagłówkiem a treścią

Diagnostykę rozpoczyna się od porównania trzech elementów: adresu żądania, kodu statusu i pełnej odpowiedzi HTTP. Warto sprawdzić wartość nagłówka Content-Type, początek treści oraz ewentualne nagłówki pośrednie dodane przez serwer proxy, bramę sieciową lub mechanizm przekierowania. Do ręcznego odczytu odpowiedzi można użyć polecenia curl -i https://example.com/api, które pokazuje nagłówki wraz z treścią. W środowisku testowym pomocne jest również zapisanie surowej odpowiedzi przed wykonaniem deserializacji.

Jeżeli odpowiedź zaczyna się od <!DOCTYPE html>, znacznika <html> albo komunikatu generowanego przez serwer WWW, a Content-Type wskazuje application/json, problem leży po stronie odpowiedzialnej za formatowanie odpowiedzi lub obsługę wyjątku. Jeżeli treść jest poprawnym JSON-em, lecz nagłówek wskazuje typ tekstowy, należy sprawdzić konfigurację endpointu, middleware oraz sposób ustawiania nagłówków w kodzie serwera. Trzeba także zweryfikować przekierowania, ponieważ klient może ostatecznie otrzymać odpowiedź z innego adresu niż pierwotnie żądany. W przypadku danych tekstowych znaczenie może mieć parametr charset, jednak nie powinien on zastępować właściwego typu MIME.

Wpływ błędnego Content-Type na działanie komputera

Nieprawidłowy Content-Type nie oznacza automatycznie awarii sprzętu. Jest to problem komunikacji między aplikacją kliencką a usługą HTTP, który może objawić się pustym widokiem, komunikatem o błędzie, nieudaną synchronizacją albo przerwaniem pracy programu. Na laptopie lub komputerze PC warto sprawdzić, czy problem występuje w jednej aplikacji, w konkretnej przeglądarce czy przy każdym połączeniu z danym adresem. Pomocne jest porównanie odpowiedzi z pamięci podręcznej i z żądania wykonanego w trybie prywatnym, a także sprawdzenie, czy lokalne rozszerzenie lub program filtrujący ruch nie podmienia odpowiedzi.

Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów, komputerów PC i ich podzespołów, a w przypadku problemu z nieprawidłowym Content-Type może pomóc ustalić, czy przyczyną jest aplikacja, konfiguracja systemu, przeglądarka lub lokalna komunikacja sieciowa. Prawidłowa naprawa wymaga oddzielenia usterki komputera od błędu po stronie serwera API, ponieważ zmiana ustawień urządzenia nie naprawi niezgodnego nagłówka generowanego przez zewnętrzną usługę.