Location
O cabeçalho de resposta Location
indica o URL para qual página deve-se ser redirecionada. Ele só tem significado quando é enviado junto a uma resposta de status 3xx
(redirecionamento) ou 201
(criado).
Em casos de redirecionamento, o método HTTP utilizado para fazer a nova requisição à página apontada pelo cabeçalho Location
depende do método original e do tipo de redirecionamento:
- Se respostas com status
303
(Veja também) sempre levam ao uso do métodoGET
,307
(Redirecionamento Temporário) e308
(Redirecionamento Permanente) não mudam o método utilizado na requisição original; 301
(Movido Permanentemente) e302
(Encontrado) não mudam o método na maior parte das vezes, entretanto agentes de usuário antigos talvez mudem (basicamente você não sabe se eles farão isso).
Todas as respostas com um desses códigos de status enviam um cabeçalho Location
.
Em casos de recursos de criação, ele indica o URL para o novo recurso criado.
Location
e Content-Location
são diferentes: Location
indica o alvo de redirecionamento (ou URL do novo recurso criado), enquanto Content-Location
indica o URL direto para ter acesso ao recurso quando negociação de conteúdo acontecer, sem a necessidade de futura negociação de conteúdo. Location
é um cabeçalho associado com a resposta, enquanto Content-Location
é associado com a entidade retornada.
Tipo de cabeçalho | Response header |
---|---|
Forbidden header name | não |
Sintaxe
Location: <url>
Diretivas
- <url>
-
Uma URL relativa (ao URL de requisição) ou absoluta.
Exemplos
Location: /index.html
Especificações
Especificação | Título |
---|---|
RFC 7231, sessão 7.1.2: Location | Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content |
Compatibilidade com navegadores
BCD tables only load in the browser