files/pt-br/web/http/headers/location/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

---
title: Location
slug: Web/HTTP/Headers/Location
tags:
  - Cabeçalho HTTP
  - Cabeçalho de Resposta
  - HTTP
translation_of: Web/HTTP/Headers/Location
original_slug: Web/HTTP/Headers/Localização
---
<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: &lt;url&gt;
</pre>

<h2 id="Diretivas">Diretivas</h2>

<dl>
 <dt>&lt;url&gt;</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>