Kategoria: Formularze i API

HTTP 415 Unsupported Media Type przy wysyłaniu formularza

Poradnik techniczny · Kacper Bernecki

Serwer odrzuca poprawne dane formularza statusem 415 zanim przejdzie do walidacji treści. Endpoint oczekuje innego Content-Type niż deklarowany przez klienta, np. JSON vs multipart/form-data.

Jak ustalić źródło błędu

Sprawdź nagłówek Content-Type oraz faktyczny format payloadu w Network.

Porównaj typ deklarowany przez API z parserem użytym po stronie serwera.

Co zrobić krok po kroku

1. Dla JSON ustaw application/json i wyślij rzeczywisty JSON.stringify obiektu. Rozdziel przesyłanie zwykłych pól od plików; większość bibliotek inaczej serializuje FormData niż obiekty JSON.

2. Dla FormData nie ustawiaj ręcznie boundary; pozwól przeglądarce utworzyć poprawny nagłówek multipart.

Jak sprawdzić wynik

Serwer prawidłowo parsuje oba przewidziane formaty albo jasno odrzuca nieobsługiwany typ.

Czego nie robić

Nie ustawiaj Content-Type: application/json dla surowego obiektu FormData.