413 Payload Too Large ("полезная нагрузка слишком велика")

https://httpcat.ru/413

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 413 Payload Too Large означает, что тело запроса превышает максимально допустимый размер, установленный сервером, и поэтому не может быть обработано.

Основные характеристики:

Сервер отклоняет запрос, потому что он содержит **слишком большой объём данных**
Может использоваться для защиты от перегрузки, атак или превышения лимитов загрузки
Запрос не обрабатывается полностью, даже если остальные параметры корректны

Типичное использование:

POST /upload HTTP/1.1
Host: example.com
Content-Type: image/jpeg
Content-Length: 104857600

(binary image content...)

HTTP/1.1 413 Payload Too Large
Content-Type: application/json

{
    "error": "Uploaded file exceeds maximum allowed size of 10MB"
}

Особенности заголовков:

Content-Length — используется клиентом, чтобы указать размер тела запроса
Retry-After — (опционально) указывает, через сколько времени клиент может повторить попытку

Когда использовать:

Когда клиент отправляет слишком большой файл или JSON-объект
Если превышен лимит на размер запроса, установленный в конфигурации сервера или API
В системах с ограничениями на загрузку файлов (например, 2MB, 10MB, 100MB)

Дополнительно:

Сервер может сообщить в теле ответа или заголовках, какой размер допустим
В веб-приложениях клиенту стоит проверять размер файла до отправки
Может быть предотвращён на клиенте с помощью HTML-ограничений, JavaScript или HTTP-заголовков

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/413