Дата публикации: 04 июля 2026 г. 19:30 (по московскому времени)
Что скрывается за цифрами 415?
Код состояния HTTP 415 Unsupported Media Type (неподдерживаемый тип медиа) означает, что сервер отказался обрабатывать запрос, потому что формат передаваемых данных не поддерживается целевым ресурсом для указанного HTTP-метода. Проще говоря, клиент «принёс» данные в неправильной «упаковке», и сервер их «не принимает».
Почему возникает 415?
- Неверный или отсутствующий заголовок
Content-Type
Пример: клиент отправляет JSON, но забывает указатьContent-Type: application/json. - Неправильный MIME-тип
Например, сервер ожидаетapplication/json, а клиент шлётtext/plainилиapplication/xml. - Несовпадение кодировки
ЗаголовокContent-Type: application/json; charset=utf-8может быть воспринят как отличный отapplication/json, если сервер строго проверяет точное совпадение. - Отсутствие необходимых библиотек на сервере
Серверу, например, не хватает JAXB-драйвера для XML или Jackson для JSON. - Ошибки в теле запроса
Даже при корректномContent-Typeтело может быть повреждено или не соответствовать схеме.
Как быстро исправить 415 в Postman
Проверьте заголовок Content-Type
- Вкладка Headers → добавьте
Content-Typeсо значениемapplication/json.
Укажите правильную кодировку
- Рекомендуется
application/json; charset=utf-8, но проверьте документацию API: некоторые фреймворки игнорируют параметрcharset.
Настройте тело запроса
- Вкладка Body → выберите raw → формат JSON.
- Убедитесь, что JSON валиден (нет лишних запятых, правильные кавычки).
Пример корректного запроса
POST https://api.example.com/v1/users
Headers:
Content-Type: application/json
Body (raw):
{
"name": "Иван",
"age": 30
}
Исправление 415 в Spring Boot / ASP.NET Core
Spring Boot
- Убедитесь, что в
pom.xmlилиbuild.gradleприсутствует зависимостьspring-boot-starter-web(включает Jackson). - На методе контроллера используйте
@RequestBody:
@PostMapping("/users")
public User createUser(@RequestBody UserDto dto) { ... }
ASP.NET Core
- Добавьте NuGet-пакет
Microsoft.AspNetCore.Mvc.NewtonsoftJson. - В
Program.cs:
builder.Services.AddControllers
.AddNewtonsoftJson;
Чек-лист для отладки
- ✔ Заголовок
Content-Typeточно совпадает с ожидаемым сервером. - ✔ Тело запроса соответствует указанному типу (валидный JSON, XML и т.д.).
- ✔ Сервер имеет нужные парсеры/драйверы.
- ✔ В логах сервера нет сообщений о нехватке библиотек.
- ✔ Эндпоинт поддерживает нужный HTTP-метод (POST/PUT/PATCH).
Ошибка 415 почти всегда решается за 2–3 минуты: достаточно проверить заголовок Content-Type, убедиться в корректности тела запроса и наличии нужных зависимостей на сервере. Если вы всё сделали по инструкции, а сервер всё равно возвращает 415 — смотрите логи: они подскажут, чего именно не хватает.
Удачи в отладке и помните: правильная «упаковка» данных — половина успеха!