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

Его следует включать только в ответы 206 Partial Content или 416 Range Not Satisfiable.

Синтаксис

Content-Range: <unit> <range>/<size>
Content-Range: <unit> <range>/*
Content-Range: <unit> */<size>

Директивы

<unit>

Единица измерения для указания диапазонов. В настоящее время поддерживается только bytes.

<range>

Диапазон в формате <range-start>-<range-end>, где <range-start> и <range-end> — целые числа, обозначающие соответственно начальную и конечную позиции (с нуля и включительно) диапазона в заданном <unit>. * используется в ответе 416 Range Not Satisfiable, чтобы указать, что значение не является диапазоном.

<size>

Общая длина документа (или *, если она неизвестна).

Примеры

Ответ с частичным содержимым

Этот ответ 206 Partial Content содержит часть ресурса; Content-Range указывает, что в ответ включены первые 1024 байта файла размером 146515 байт.

HTTP/2 206
content-type: image/jpeg
content-length: 1024
content-range: bytes 0-1023/146515
…

(binary content)

Диапазон не может быть обработан

Если сервер не может выполнить запрошенный запрос диапазона, он должен ответить статусом 416 Range Not Satisfiable, а в Content-Range указать * для диапазона вместе с общим размером ресурса.

HTTP/2 416

Content-Range: bytes */67589

Спецификации

Совместимость с браузерами

См. также

• Запросы диапазона HTTP — руководство
• If-Range, Range — заголовки
• Content-Type
• 206 Partial Content, 416 Range Not Satisfiable — коды состояния