diff options
Diffstat (limited to 'files/pt-br/web/http/headers/localização/index.html')
-rw-r--r-- | files/pt-br/web/http/headers/localização/index.html | 82 |
1 files changed, 82 insertions, 0 deletions
diff --git a/files/pt-br/web/http/headers/localização/index.html b/files/pt-br/web/http/headers/localização/index.html new file mode 100644 index 0000000000..2b8ebcc404 --- /dev/null +++ b/files/pt-br/web/http/headers/localização/index.html @@ -0,0 +1,82 @@ +--- +title: Location +slug: Web/HTTP/Headers/Localização +tags: + - Cabeçalho HTTP + - Cabeçalho de Resposta + - HTTP +translation_of: Web/HTTP/Headers/Location +--- +<div>{{HTTPSidebar}}</div> + +<p>O cabeçalho de resposta <strong><code>Location</code></strong> indica o URL para qual página deve-se ser redirecionada. Ele só tem significado quando é enviado junto a uma resposta de status <code>3xx</code> (redirecionamento) ou <code>201</code> (criado).</p> + +<p>Em casos de redirecionamento, o método HTTP utilizado para fazer a nova requisição à página apontada pelo cabeçalho <code>Location</code> depende do método original e do tipo de redirecionamento:</p> + +<ul> + <li>Se respostas com status {{HTTPStatus("303")}} (Veja também) sempre levam ao uso do método {{HTTPMethod("GET")}}, {{HTTPStatus("307")}} (Redirecionamento Temporário) e {{HTTPStatus("308")}} (Redirecionamento Permanente) não mudam o método utilizado na requisição original;</li> + <li>{{HTTPStatus("301")}} (Movido Permanentemente) e {{HTTPStatus("302")}} (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).</li> +</ul> + +<p>Todas as respostas com um desses códigos de status enviam um cabeçalho <code>Location</code>.</p> + +<p>Em casos de recursos de criação, ele indica o URL para o novo recurso criado.</p> + +<p><code>Location</code> e {{HTTPHeader("Content-Location")}} são diferentes: <code>Location</code> indica o alvo de redirecionamento (ou URL do novo recurso criado), enquanto {{HTTPHeader("Content-Location")}} indica o URL direto para ter acesso ao recurso quando <a href="/en-US/docs/Web/HTTP/Content_negotiation">negociação de conteúdo</a> acontecer, sem a necessidade de futura negociação de conteúdo. <code>Location</code> é um cabeçalho associado com a resposta, enquanto {{HTTPHeader("Content-Location")}} é associado com a entidade retornada.</p> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">Tipo de cabeçalho</th> + <td>{{Glossary("Response header")}}</td> + </tr> + <tr> + <th scope="row">{{Glossary("Forbidden header name")}}</th> + <td>não</td> + </tr> + </tbody> +</table> + +<h2 id="Sintaxe">Sintaxe</h2> + +<pre class="syntaxbox">Location: <url> +</pre> + +<h2 id="Diretivas">Diretivas</h2> + +<dl> + <dt><url></dt> + <dd>Uma URL relativa (ao URL de requisição) ou absoluta.</dd> +</dl> + +<h2 id="Exemplos">Exemplos</h2> + +<pre>Location: /index.html</pre> + +<h2 id="Especificações">Especificações</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificação</th> + <th scope="col">Título</th> + </tr> + <tr> + <td>{{RFC("7231", "Location", "7.1.2")}}</td> + <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidade_de_navegadores">Compatibilidade de navegadores</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("http.headers.Location")}}</p> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{HTTPHeader("Content-Location")}}</li> + <li>Código de status de respostas que incluem o cabeçalho <code>Location</code>: {{HTTPStatus("201")}}, {{HTTPStatus("301")}}, {{HTTPStatus("302")}}, {{HTTPStatus("303")}}, {{HTTPStatus("307")}}, {{HTTPStatus("308")}}.</li> +</ul> |