Поиск
Ошибки

Ошибка 415 Unsupported Media Type: что значит и как исправить

415 Unsupported Media Type («неподдерживаемый тип данных») — сервер отказался принять данные запроса из-за их формата. Формат клиент указывает в заголовке Content-Type: например, сервер ждёт JSON, а программа прислала данные формы или простой текст.

≈ 6 мин чтения
Содержание 11

Что сделать прямо сейчас

  1. Если ошибка появилась при загрузке файла на сайт, проверьте формат файла: возможно, сайт принимает только определённые — например, JPG и PNG для фото. Сохраните файл в нужном формате и загрузите снова.
  2. Если ошибка повторяется, напишите владельцу сайта: адрес страницы, время и что отправляли.
  3. Если 415 получает ваша программа, проверьте заголовок Content-Type, который она отправляет. Как это сделать — в разделе «Как проверить».

Если сайт ваш и работает на VPS с nginx, переходите к разделу «Как найти причину по журналу». Если сайт на виртуальном хостинге — к разделу «На виртуальном хостинге».

Что означает код 415

Когда клиент отправляет данные — форму, файл, JSON, — он сообщает их формат в заголовке Content-Type. Форматы, с которыми работают формы и API:

Content-TypeЧто внутриКак отправить из curl
application/jsonДанные в формате JSONКлюч --json
application/x-www-form-urlencodedПоля формы без файловКлюч -d
multipart/form-dataПоля формы вместе с файламиКлюч -F
text/plainПростой текстКлюч -H с этим заголовком

По стандарту HTTP код 415 значит: сервер отказывается обработать запрос, потому что данные в нём в неподдерживаемом формате. Сервер может определить это по заголовку Content-Type, по заголовку Content-Encoding — способу сжатия данных — или заглянув в сами данные.

Если дело в сжатии, серверу следует указать в ответе заголовок Accept-Encoding со способами сжатия, которые он принимает. Если дело в формате, ответ может содержать заголовок Accept со списком подходящих форматов.

Как проверить

Команду выполняйте в терминале на своём компьютере, подставив адрес своего сайта. Если терминал вам незнаком, начните с инструкции Как открыть терминал. Вместо адреса из примера подставьте тот, куда ваша программа отправляет данные. Сначала отправьте данные в формате JSON:

curl -i --json '{"name":"test"}' https://example.com/api/orders/

Ключ --json сам добавляет заголовок Content-Type: application/json. Затем отправьте те же данные с ключом -d: curl укажет формат application/x-www-form-urlencoded, как у данных формы.

curl -i -d '{"name":"test"}' https://example.com/api/orders/

Если первая команда проходит, а вторая получает 415, сервер по этому адресу принимает JSON. Проверьте, какой Content-Type отправляет ваша программа.

Команды отправляют настоящий запрос: если адрес создаёт записи, появится тестовая запись — потом удалите её. Ключ --json есть в curl с версии 7.82.0.

В JavaScript

Если данные отправляет код на странице через fetch, а тело запроса — строка, браузер по умолчанию ставит заголовок Content-Type: text/plain;charset=UTF-8. Сервер, который ждёт JSON, может ответить на такой запрос 415. Укажите формат явно:

fetch('/api/orders/', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'test'})
});

Какой Content-Type ушёл на самом деле, видно в инструментах разработчика. Откройте их клавишей F12, на Mac — Cmd+Option+I, перейдите на вкладку Network («Сеть»), отправьте данные, нажмите на запрос в списке и найдите заголовки запроса.

Когда 415 отдаёт nginx

Сам nginx отвечает 415 в модуле WebDAV: на запросы DELETE, MKCOL, COPY и MOVE с телом. Причину он записывает в журнал ошибок, например «DELETE with body is unsupported». Последние записи журнала покажет команда на сервере:

sudo tail -n 50 /var/log/nginx/error.log

Если WebDAV на сайте не настроен, 415 присылает программа, которой nginx передаёт запросы.

Как найти причину по журналу

Команды из этого раздела выполняйте на сервере — как к нему подключиться, рассказано в инструкции Как подключиться к VPS по SSH. Если вы ни разу не открывали терминал, начните с инструкции Как открыть терминал: там всё по шагам.

Все запросы nginx записывает в журнал доступа — в Ubuntu и Debian это файл /var/log/nginx/access.log. Какими методами и на какие адреса приходили запросы с ответом 415, покажет команда:

sudo awk '/" 415 / {print $6, $7}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -20

В каждой строке ответа — сколько было таких запросов, затем метод с кавычкой перед ним и адрес. Например:

     23 "POST /api/orders/
      1 "DELETE /files/old.txt

Команда рассчитана на стандартный формат журнала nginx. Если в файле настроек сайта есть своя строка access_log, подставьте в команду путь из неё. Если команда ничего не вывела, записей с 415 в журнале нет.

Как исправить

  • Отправляйте данные в формате, который ждёт сервер, и указывайте его в Content-Type. Какой формат нужен, сказано в документации API.
  • Для JSON указывайте Content-Type: application/json, а сами данные превращайте в строку JSON — в JavaScript это делает JSON.stringify.
  • Файлы отправляйте как multipart/form-data — в curl это ключ -F, — если в документации API не сказано иначе.
  • Если данные сжаты, проверьте, принимает ли сервер этот способ сжатия: в ответе 415 он может перечислить подходящие в заголовке Accept-Encoding.
  • Запросы DELETE, MKCOL, COPY и MOVE к WebDAV в nginx отправляйте без тела.

На виртуальном хостинге

Если 415 получает ваш скрипт, когда обращается к чужому API, проверьте Content-Type, как описано выше. Если 415 видят посетители при отправке форм на ваш сайт, проверьте настройки программы сайта или напишите в поддержку хостинга: адрес страницы, время и что отправляли.

415 и поиск Яндекса

По справке Яндекса, при ответе 415 запрос отклонён, потому что его тело в неподдерживаемом формате. Яндекс советует добавить поддержку нужных форматов данных и проверить, что все обработчики содержимого настроены правильно.

Чем 415 отличается от соседних кодов

КодКогда возникает
400Запрос испорчен, сервер не может его разобрать
406Сервер не может ответить в формате, который просит клиент
413Тело запроса больше, чем разрешено на сервере
415Тело запроса в формате, который сервер не принимает
422Формат подходит, но данные не прошли проверку

Источники

Сверено 19 октября 2026 года.

Что почитать дальше