O servidor responde com o próximo endereço
Um redirecionamento HTTP é uma resposta que orienta o cliente a fazer outra requisição para um endereço indicado no cabeçalho Location. O navegador normalmente segue essa indicação e carrega o destino. A resposta de redirecionamento e a resposta com o conteúdo final pertencem a requisições diferentes.
O código 301 comunica uma mudança permanente. O 302 indica um destino temporário, portanto o endereço original continua sendo a referência para acessos futuros. Ao escolher o código, você também precisa considerar o método da requisição seguinte.
Uma página transferida para outro caminho
Neste exemplo didático, o cliente faz um GET para /guia-antigo/. A página foi transferida para /guia-novo/, por isso o servidor responde com o status e o cabeçalho abaixo:
HTTP/1.1 301 Moved PermanentlyLocation: /guia-novo/O status informa a mudança permanente e Location aponta para outro caminho no mesmo domínio. O cliente faz uma nova requisição a /guia-novo/ para obter a página. Um aviso de mudança no corpo de uma resposta 200 não produz esse redirecionamento HTTP.
O método pode mudar ao seguir o destino
Nos códigos 301 e 302, o cliente pode converter um POST em GET. Os códigos 307 e 308 preservam o método e o corpo ao seguir o redirecionamento, sendo temporário o primeiro e permanente o segundo. Já o 303 permite consultar outro recurso por GET ou HEAD, como uma página de confirmação após o envio de um formulário.
Para conferir uma alteração, observe o status e o cabeçalho Location da resposta inicial na aba de rede do navegador. Examine também a requisição ao destino: ela mostra o método efetivamente usado e permite identificar outros redirecionamentos no caminho.
Dúvidas frequentes
Perguntas frequentes sobre redirecionamento
- O destino precisa estar em outro domínio?
- O cabeçalho Location pode indicar outro caminho no mesmo domínio. A mudança de domínio é uma possibilidade, não uma condição para redirecionar.
- Todo status 3xx manda abrir outro endereço?
- O 304 Not Modified faz parte da classe 3xx, mas responde a uma consulta condicional para permitir o uso de uma representação já armazenada em cache. Ele não manda abrir uma nova URL.
- Como um ciclo de redirecionamentos acontece?
- Uma sequência pode levar de volta a um endereço já visitado, como /antigo/ apontando para /novo/ e /novo/ apontando para /antigo/. O navegador repete os acessos até detectar o ciclo ou atingir seu limite.
Para continuar
Recursos relacionados
Documentação
MDN: redirecionamentos HTTP
Explicação dos redirecionamentos HTTP, das diferenças entre códigos e dos ciclos causados pela configuração dos destinos.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Sessão ao vivo para testar rotas e conferir o status, o destino e o método das requisições após alterações no site.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A alteração de rotas exige testar o endereço de destino e o comportamento das requisições feitas pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.