416 Request Range Not Satisfiable ("диапазон не достижим")

https://httpcat.ru/416

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

Описание

Код состояния 416 Range Not Satisfiable означает, что клиент запросил диапазон байтов, который находится вне допустимого диапазона для запрашиваемого ресурса.

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

Возникает в ответ на запрос с заголовком Range, если указанный диапазон не может быть обработан
Обычно используется при скачивании файлов, потоковом видео, докачке и других частичных загрузках
Сервер может сообщить фактический размер ресурса в заголовке Content-Range

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

GET /video.mp4 HTTP/1.1
Host: example.com
Range: bytes=10000000-20000000

HTTP/1.1 416 Range Not Satisfiable
Content-Range: bytes */8345998
Content-Type: application/json

{
    "error": "Requested range is not available"
}

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

Range — заголовок запроса, указывающий желаемый диапазон (например, bytes=0-999)
Content-Range — в ответе указывает доступный диапазон, например: bytes */8345998

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

Если клиент запрашивает байты за пределами доступного диапазона
При ошибочной докачке файла (например, файл изменился, а клиент продолжает с неправильной позиции)
Когда диапазон сформулирован некорректно (например, bytes=1000-500)

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

Клиент может использовать HEAD-запрос, чтобы определить размер ресурса до начала загрузки
Отличие от 206 Partial Content: 206 возвращает корректный диапазон, 416 — если запрошенный недопустим
Может использоваться в браузерах, медиаплеерах, загрузчиках и API с поддержкой range-запросов

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