Range

O cabeçalho de requisição HTTP Range indica a parte do documento que o servidor deve retornar. Várias partes podem ser requisitadas com um cabeçalho Range de uma vez, e o servidor pode mandar de volta estes intervalos em um documento de múltiplas partes. Se o servidor manda de volta os intervalos, ele usa o 206 Partial Content para resposta. Se os intervalos são inválidos, o servidor retorna o erro 416 Range Not Satisfiable. O servidor também pode ignorar o cabeçalho Range e enviar o documento inteiro com um código de status 200.

Sintaxe

Range: <unit>=<range-start>-
Range: <unit>=<range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>, <range-start>-<range-end>
Range: <unit>=-<suffix-length>

Diretivas

<unit>

A unidade no qual os intervalos são especificados. É geralmente em bytes.

<range-start>

Um inteiro na dada unidade indicando o começo da requisição de intervalo.

<range-end>

Um inteiro na dada unidade indicando o fim da requisição de intervalo. Este valor é opcional e, se omitido, o fim do documento é utilizado como fim do intervalo.

<suffix-length>

Um inteiro na dada unidade indicando o número de unidades ao fim do arquivo para retornar.

Exemplos

Requisitando três intervalos deste arquivo.

Range: bytes=200-1000, 2000-6576, 19000- 

Requisitando os primeiros 500 e últimos 500 bytes do arquivo. A requisição pode ser rejeitada pelo servidor se os intervalos se sobrepõem.

Range: bytes=0-499, -500 

Especificações

Compatibilidade de navegador

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Veja também

• If-Range
• Content-Range
• Content-Type
• 206 Partial Content
• 416 Range Not Satisfiable