Referência de Códigos de Status HTTP — Guia Completo para Devs e SEOs
Toda resposta HTTP vem acompanhada de um código de três dígitos que informa ao cliente — e aos crawlers como o Googlebot — o que aconteceu com a requisição. Se você está depurando um erro 502 bad gateway, decidindo entre um redirecionamento 301 ou 302, ou projetando a resposta de uma API REST, esta referência traz o significado, os casos de uso e as notas práticas de cada código.
Busque pelo número do código ou por palavra-chave, ou filtre por classe usando os botões acima.
Classes de Códigos de Status HTTP — O Que o Primeiro Dígito Significa
O primeiro dígito define a classe do código. Entender as cinco classes é a forma mais rápida de diagnosticar qualquer erro HTTP:
| Classe | Intervalo | Significado | Impacto no SEO |
|---|---|---|---|
| 1xx | 100–199 | Informacional — requisição recebida | Mínimo — raramente visto por crawlers |
| 2xx | 200–299 | Sucesso — requisição concluída | Crítico: 200 obrigatório para indexação |
| 3xx | 300–399 | Redirecionamento — ação adicional necessária | Alto: 301 passa link equity; 302 não consolida |
| 4xx | 400–499 | Erro do cliente — requisição inválida ou recurso não encontrado | Alto: 404/410 removem páginas do índice |
| 5xx | 500–599 | Erro do servidor — falha interna | Alto: 5xx persistente reduz rastreamento e causa desindexação |
Os Códigos de Status HTTP Mais Importantes Explicados
2xx — Códigos de Sucesso
200 OK é o código base. A requisição foi bem-sucedida e o servidor retornou o recurso solicitado. Este é o único código que torna uma página elegível para indexação pelo Google. Fique atento aos "soft 404s" — páginas que retornam 200 mas exibem conteúdo vazio ou mensagens de erro, que o Google trata como páginas ausentes desperdiçando crawl budget.
201 Created é a resposta correta após uma requisição POST que criou um novo recurso em uma API REST. Não é visto por crawlers em páginas HTML públicas.
204 No Content sinaliza sucesso sem corpo na resposta. Use em endpoints DELETE e PATCH quando não é necessário retornar dados atualizados.
3xx — Códigos de Redirecionamento
301 Moved Permanently é o redirecionamento permanente. Ele consolida sinais de ranqueamento — incluindo link equity e PageRank — da URL antiga para a nova. Use para reestruturação de URLs, migração HTTP para HTTPS, mudanças de domínio e qualquer cenário onde a URL antiga não voltará. Redirecionamentos 301 são armazenados em cache pelos navegadores de forma agressiva — teste com cuidado antes de implantar em escala.
302 Found é o redirecionamento temporário. O Google também passa sinais de ranqueamento por 302s na implementação atual, mas manter um 302 por longo prazo cria ambiguidade de canonical e impede o Google de atualizar o índice. Use o 302 para testes A/B, redirecionamentos geográficos e páginas de promoções temporárias.
304 Not Modified instrui o navegador a usar a versão em cache. O recurso não mudou desde a última requisição. Reduz o consumo de banda e acelera visitas recorrentes sem impacto negativo no SEO.
4xx — Códigos de Erro do Cliente
401 Unauthorized significa que a autenticação é necessária e não foi fornecida ou é inválida. O usuário precisa fazer login ou fornecer uma chave de API. Diferente do 403 — 401 significa "Quem é você?" enquanto 403 significa "Sei quem você é, mas não pode entrar."
403 Forbidden significa que o servidor entendeu a requisição, mas se recusa a autorizá-la. A identidade do cliente é conhecida, mas falta permissão. Do ponto de vista do SEO, se o Googlebot receber um 403 em uma página anteriormente indexada, ela pode eventualmente ser removida dos resultados.
404 Not Found é o erro mais comum na web. Um número moderado de 404s é normal — eles só se tornam um problema quando páginas importantes retornam 404 sem redirecionamento, desperdiçando link equity. Redirecione 404s valiosos com um 301 para a alternativa mais relevante.
410 Gone é o sinal de remoção permanente. Mais forte e mais rápido que o 404 — o Google processa o 410 para remoção de URL muito mais rapidamente. Use quando você retira intencionalmente um conteúdo que nunca voltará.
429 Too Many Requests sinaliza limitação de taxa. Se o Googlebot receber respostas 429, ele reduz a velocidade de rastreamento, diminuindo seu crawl budget. Implemente rate limiting com cuidado para não bloquear crawlers de forma agressiva.
5xx — Códigos de Erro do Servidor
500 Internal Server Error é uma falha genérica no servidor. Monitore 500s no Google Search Console — erros 500 persistentes em uma URL fazem o Google reduzir a frequência de rastreamento e podem causar desindexação.
502 Bad Gateway significa que o servidor recebeu uma resposta inválida de um servidor upstream. Comum com Nginx ou Cloudflare quando o servidor de aplicação cai, trava ou fica sobrecarregado após um deploy com falha.
503 Service Unavailable significa que o servidor está temporariamente indisponível. Sempre inclua um cabeçalho Retry-After para que o Google saiba quando rastrear novamente. Sem ele, 503s persistentes podem causar desindexação. Este é o código correto para retornar durante manutenção programada.
504 Gateway Timeout significa que o gateway não recebeu uma resposta a tempo do servidor upstream. Causa mais comum: uma query de banco de dados lenta, uma chamada de API travada ou um job em segundo plano que excede o timeout da requisição.
301 vs 302 — Quando Usar Cada Um
| Cenário | Use | Motivo |
|---|---|---|
| Página movida permanentemente | 301 | Passa link equity completo para a nova URL |
| Migração para HTTPS | 301 | Permanente — consolida sinais de ranqueamento |
| Mudança de domínio | 301 | Permanente — preserva o ranqueamento |
| Teste A/B | 302 | Temporário — mantém a URL original como canonical |
| Página de promoção sazonal | 302 | Temporário — URL original retorna após a promo |
| Redirecionamento geográfico | 302 | Temporário — varia por localização do usuário |
| Página de manutenção | 503 + Retry-After | Não é redirect — servidor temporariamente indisponível |
Perguntas Frequentes
Qual a diferença entre os códigos HTTP 404 e 410?
Tanto 404 Not Found quanto 410 Gone informam ao navegador e aos crawlers que uma página está indisponível. A diferença principal é permanência e intenção. Um 404 significa que o servidor não encontrou o recurso — ele pode existir novamente no futuro. Um 410 declara explicitamente que o recurso foi removido permanentemente e não vai retornar. Do ponto de vista do SEO, o Google processa o 410 mais rapidamente que o 404 para remoção de URL — use o 410 quando você retira conteúdo intencionalmente e quer que o Google o remova do índice mais rápido.
Qual a diferença entre 401 Unauthorized e 403 Forbidden?
Ambos os códigos indicam que o acesso foi negado, mas por motivos diferentes. 401 Unauthorized significa que o cliente não se autenticou — o servidor não sabe quem você é e você precisa fornecer credenciais (fazer login ou fornecer uma API key). 403 Forbidden significa que o servidor sabe quem você é, mas recusa o acesso — você está autenticado, mas não tem permissão para acessar aquele recurso. Resumindo: 401 = "Quem é você?", 403 = "Sei quem você é, mas não pode entrar."
Um redirecionamento 301 passa link equity (valor de SEO) para a nova URL?
Sim. Um redirecionamento 301 Moved Permanently consolida os sinais de ranqueamento — incluindo link equity, PageRank e autoridade de indexação — da URL antiga para a nova. O Google confirmou que redirecionamentos 301 passam link equity "completo", embora cadeias de redirecionamento (múltiplos saltos) possam causar alguma perda de sinal. Um 302 Found também passa sinais na implementação atual do Google, mas o 301 é sempre a escolha mais segura para movimentações permanentes.
Como os códigos de status HTTP afetam o rastreamento e a indexação pelo Google?
Os códigos de status determinam diretamente como o Googlebot trata cada URL. Um 200 OK torna a página elegível para indexação. Um 301 diz ao Google para atualizar o índice com a nova URL e transferir o link equity. Um 404 ou 410 indica que a página foi removida — ela eventualmente sairá do índice. Um 503 com cabeçalho Retry-After diz ao Google para tentar novamente mais tarde sem desindexar. Erros 5xx persistentes fazem o Google reduzir a frequência de rastreamento e eventualmente desindexar as páginas afetadas.
O que é um "soft 404" e por que é um problema de SEO?
Um soft 404 ocorre quando uma página retorna 200 OK, mas exibe conteúdo que parece uma página de erro — resultado vazio, "nenhum produto encontrado" ou uma mensagem genérica de "página indisponível". O Google detecta isso visualmente e trata como um 404 real, classificando a URL como conteúdo ausente. Isso desperdiça crawl budget e impede que a página seja indexada ou ranqueada. A correção é retornar um código 404 ou 410 real, ou preencher a página com conteúdo genuíno e relevante.
Recursos
- MDN Web Docs — Códigos de status de resposta HTTP — A referência oficial de todos os códigos de status HTTP com especificações detalhadas.
- RFC 9110 — HTTP Semantics — O padrão IETF oficial que define a semântica e o comportamento dos códigos de status HTTP.
- Google Search Central — Erros de rede HTTP — Como o Googlebot interpreta códigos de status específicos e seu impacto no rastreamento e indexação.