Как исправить HTTP-запрос, который возвращает ошибку ‘Формат сообщения не поддерживается’ (415 Unsupported Media Type)?

Question

Как исправить HTTP-запрос, который возвращает ошибку ‘Формат сообщения не поддерживается’ (415 Unsupported Media Type)?

Тип вопроса: API тестирование Вероятность: 23% Категория: AQA / Automation

Ответ

Ошибка 415 Unsupported Media Type означает, что сервер отказывается обрабатывать запрос из-за несоответствия формата данных. Исправления касаются в основном заголовков и тела запроса.

Основные причины и исправления:

Неверный заголовок Content-Type: Это самая частая причина. Заголовок должен точно соответствовать формату тела запроса.
- Для JSON: Content-Type: application/json
- Для XML: Content-Type: application/xml
- Для форм: Content-Type: application/x-www-form-urlencoded или multipart/form-data
Невалидное тело запроса: Даже с правильным Content-Type, сервер вернет 415, если не может распарсить тело.
- Для JSON: Убедитесь в отсутствии синтаксических ошибок (лишние/пропущенные запятые, кавычки).
- Используйте валидаторы JSON.
Отсутствие обязательного заголовка Content-Type: Некоторые API требуют явного указания заголовка даже для GET-запросов с пустым телом.

Пример исправления запроса:

Неправильно (вызывает 415):

POST /api/users HTTP/1.1
Host: api.example.com

{"name": "Alice", "age": 30}

Правильно:

POST /api/users HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: application/json

{
  "name": "Alice",
  "age": 30
}

Действия по диагностике:

Проверьте документацию API на предмет ожидаемых форматов.
Используйте инструменты вроде Postman или curl с флагом -v для детального просмотра отправляемых заголовков.
Убедитесь, что клиентская библиотека (например, requests в Python) не переопределяет заголовки по умолчанию некорректно.

Ответ 18+ 🔞

А, слушай, вот эта ошибка 415, блядь! Это ж классика, ёпта! Сервер такой: «Ты чё, мудила, мне подсунул? Я такое не жую, нахуй!» И в ответ — холодный, блядь, отказ.

Короче, суть в том, что ты пытаешься скормить серверу данные в таком формате, от которого у него, блядь, аллергия. Он их читать не умеет и не хочет. И в основном, блядь, косяк вот в чём:

Заголовок Content-Type — кривой или его вообще нет. Это, блядь, 90% всех проблем! Ты же не будешь суп вилкой хлебать? Вот и серверу надо сказать, ЧТО ты ему передаёшь.
- Кидаешь JSON? Пиши честно: Content-Type: application/json
- Лепишь старую добрую форму? Content-Type: application/x-www-form-urlencoded
- Файлы грузишь? Ну, multipart/form-data, ёпта, куда ж без него.
Само тело запроса — говно неразборчивое. Допустим, заголовок-то правильный, application/json стоит. А внутри — хуйня! Запятая лишняя, кавычки не закрыты, вротберунчик какой-то. Сервер попытается это прочитать, обосрётся и выплюнет тебе ту же 415-ю. Проверь, блядь, свой JSON через валидатор, не ленись!
Заголовка Content-Type ВООБЩЕ НЕТ. А некоторые API, пидарасы такие, требуют его даже для пустых запросов! Ну, типа, «я принципиальный, блядь, всегда говори, что ты мне несешь, даже если несешь нихуя!».

Смотри, как это выглядит на практике:

Было (и получил в жопу 415):

POST /api/users HTTP/1.1
Host: api.example.com

{"name": "Alice", "age": 30}

Сервер смотрит: а нахуя мне эта строка? Кто её, блядь, прислал? JSON? XML? Стихи? Хуй его знает. На тебе, мудак, ошибку!

Стало (и всё заебись):

POST /api/users HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: application/json

{
  "name": "Alice",
  "age": 30
}

Вот теперь чётко: «Братан, я тебе JSON несу. И хочу получить тоже JSON, окей?» И сервер доволен.

Что делать, если поймал эту ошибку?

Документацию читай, ёбта! Там чёрным по белому написано, чего от тебя хотят.
Включи режим параноика в отладке. В Postman'е или через curl -v смотри, что на самом деле летит по проводам. А то библиотека какая-нибудь, хитрая жопа, сама заголовки подменяет.
Проверь, блядь, свои данные! Может, ты там не JSON, а какую-то дичь собрал. Валидируй всё, что только можно.

Вот и весь секрет, блядь. Не суй серверу в рот то, чего он не просил, и будет тебе счастье.