Códigos de Status HTTP — Lista Completa e Significados

O servidor recebeu os cabeçalhos da requisição e o cliente deve prosseguir e enviar o corpo.

Quando usar: Enviado em resposta a uma requisição com Expect: 100-continue, para que o cliente verifique se um upload grande será aceito antes de transmiti-lo.

O servidor concorda em mudar para o protocolo indicado no cabeçalho Upgrade do cliente.

Quando usar: Usado ao atualizar uma conexão HTTP/1.1 para WebSocket (Upgrade: websocket).

WebDAV: o servidor aceitou a requisição, mas ainda não terminou de processá-la.

Quando usar: Evita que o cliente atinja o timeout em operações WebDAV longas. Hoje é raramente usado.

Permite que o servidor envie cabeçalhos Link (preload / preconnect) antes de a resposta final estar pronta.

Quando usar: Envie enquanto o backend ainda está gerando a página, para que o navegador comece a buscar CSS, fontes ou scripts críticos mais cedo.

A requisição foi bem-sucedida. O corpo contém o recurso solicitado ou o resultado da ação.

Quando usar: A resposta de sucesso padrão para GET, e para POST/PUT quando você retorna um corpo.

Impacto no SEO: O único status que permite indexar uma página com seu conteúdo. Garanta que páginas “não encontradas” não retornem 200 (um “soft 404”).

A requisição foi bem-sucedida e um novo recurso foi criado.

Quando usar: Retorne após um POST (ou PUT) que cria algo; inclua um cabeçalho Location apontando para o novo recurso.

A requisição foi aceita para processamento, mas o processamento ainda não foi concluído.

Quando usar: Tarefas assíncronas: coloque o trabalho na fila e retorne uma URL onde o cliente possa consultar o resultado.

A resposta foi modificada por um proxy de transformação e difere da resposta 200 do servidor de origem.

Quando usar: Definido por proxies que alteram o conteúdo; servidores de origem normalmente não devem enviá-lo.

A requisição foi bem-sucedida e intencionalmente não há corpo na resposta.

Quando usar: Requisições DELETE, endpoints de salvamento automático e respostas de preflight do CORS, quando não há nada a retornar.

A requisição foi bem-sucedida e o cliente deve redefinir a visualização do documento (por exemplo, limpar um formulário).

Quando usar: Raro; instrui o agente do usuário a redefinir o formulário que enviou a requisição.

O servidor está entregando apenas o intervalo de bytes solicitado no cabeçalho Range.

Quando usar: Streaming de vídeo, downloads retomáveis e gerenciadores de download.

WebDAV: o corpo é um documento XML com códigos de status separados para várias sub-requisições.

Quando usar: Operações WebDAV em lote em que itens individuais podem ter sucesso ou falhar.

WebDAV: membros de uma vinculação já foram listados antes na mesma resposta 207.

Quando usar: Evita listar o mesmo recurso repetidamente dentro de uma resposta Multi-Status.

O servidor atendeu a um GET com manipulações de instância (codificação delta) aplicadas.

Quando usar: Codificação delta do HTTP (RFC 3229); quase nunca é visto na prática.

O recurso tem várias representações e o cliente (ou o usuário) deve escolher uma.

Quando usar: Raro; a negociação de conteúdo geralmente é feita automaticamente.

Impacto no SEO: O Google pode escolher qualquer uma das opções; prefira um único 301 para a versão canônica.

O recurso tem uma nova URL permanente, informada no cabeçalho Location.

Quando usar: Mudança de domínio, HTTP → HTTPS, slugs alterados, unificação de páginas duplicadas.

Impacto no SEO: A forma padrão de mover uma página: os mecanismos de busca transferem os sinais de ranqueamento e indexam a nova URL. Os navegadores podem trocar POST por GET em um 301 — use 308 se o método precisar ser mantido.

O recurso está temporariamente em outra URL.

Quando usar: Redirecionamentos de curta duração, como páginas de manutenção, testes A/B ou fluxos de login.

Impacto no SEO: O Google trata como temporário e geralmente mantém a URL original indexada. Se a mudança for permanente, use 301.

O cliente deve buscar o resultado em outra URL usando GET.

Quando usar: O padrão “Post/Redirect/Get”: depois do envio de um formulário via POST, redirecione para uma página de confirmação.

Impacto no SEO: Tratado como um redirecionamento temporário.

A cópia em cache ainda é válida; nenhum corpo é enviado.

Quando usar: Resposta a requisições condicionais (If-None-Match / If-Modified-Since) quando o recurso não mudou.

Impacto no SEO: Bom para a eficiência do rastreamento: o Googlebot reutiliza a cópia em cache, economizando orçamento de rastreamento.

Obsoleto. Originalmente instruía o cliente a acessar o recurso por meio de um proxy.

Quando usar: Não use — os navegadores o ignoram por motivos de segurança.

Igual ao 302, mas o cliente deve repetir a requisição com o mesmo método e corpo.

Quando usar: Redirecionamentos temporários de requisições POST/PUT; os navegadores também exibem “307 Internal Redirect” para upgrades de HSTS.

Impacto no SEO: Temporário — a URL original geralmente continua indexada.

Igual ao 301, mas o cliente deve manter o mesmo método e corpo.

Quando usar: Mudanças permanentes de endpoints de API ou destinos de formulário em que um POST precisa continuar sendo POST.

Impacto no SEO: O Google trata o 308 da mesma forma que o 301 e transfere os sinais para a nova URL.

O servidor não consegue processar a requisição porque ela está malformada (sintaxe incorreta, JSON inválido, cookie grande demais…).

Quando usar: Falhas de validação que você não consegue descrever com mais precisão; inclua uma mensagem de erro no corpo.

Impacto no SEO: Páginas que retornam 4xx são removidas do índice.

É necessária autenticação, que estava ausente ou é inválida. Apesar do nome, significa “não autenticado”.

Quando usar: Token ou credenciais ausentes ou expirados. Deve incluir um cabeçalho WWW-Authenticate.

Impacto no SEO: Rastreadores não conseguem fazer login, então páginas atrás de um 401 não são indexadas — o que é desejável para áreas privadas.

Reservado para uso futuro; algumas APIs o usam quando é necessário um pagamento ou upgrade de cota.

Quando usar: Erros de cobrança não padronizados (ex.: uma assinatura vencida).

O servidor entendeu a requisição, mas se recusa a autorizá-la. Fazer login novamente não vai ajudar.

Quando usar: O usuário está logado, mas não tem permissão, ou o acesso é bloqueado por IP, WAF ou permissões de arquivo.

Impacto no SEO: Não indexado. Verifique se seu firewall ou proteção contra bots não está retornando 403 para o Googlebot por engano.

O servidor não consegue encontrar o recurso solicitado.

Quando usar: A URL nunca existiu ou foi removida sem substituto. Tenha uma página 404 personalizada e útil.

Impacto no SEO: Normal e inofensivo para páginas que realmente não existem; o Google as remove com o tempo. Redirecione (301) URLs que têm backlinks ou um substituto claro.

O método HTTP não é suportado para esta URL (ex.: POST em uma página somente leitura).

Quando usar: Retorne com um cabeçalho Allow listando os métodos suportados.

O servidor não consegue gerar uma resposta que corresponda aos cabeçalhos Accept da requisição.

Quando usar: Negociação de conteúdo estrita; muitas APIs simplesmente retornam o formato padrão.

Igual ao 401, mas o cliente deve se autenticar em um proxy.

Quando usar: Enviado por proxies corporativos ou de encaminhamento, com um cabeçalho Proxy-Authenticate.

O servidor atingiu o timeout esperando que o cliente terminasse de enviar a requisição.

Quando usar: Conexões ociosas ou muito lentas; os clientes podem tentar novamente.

A requisição entra em conflito com o estado atual do recurso.

Quando usar: Conflitos de edição, chaves únicas duplicadas ou incompatibilidade de versões em bloqueio otimista.

O recurso foi removido permanentemente e não voltará.

Quando usar: Conteúdo excluído deliberadamente, anúncios ou campanhas expirados.

Impacto no SEO: O Google trata o 410 como o 404, mas pode remover a URL um pouco mais rápido.

O servidor exige um cabeçalho Content-Length.

Quando usar: Uploads sem tamanho definido quando a codificação em partes (chunked) não é aceita.

Uma condição nos cabeçalhos da requisição (If-Match, If-Unmodified-Since) foi avaliada como falsa.

Quando usar: Concorrência otimista: rejeite uma atualização porque o recurso mudou desde que o cliente o leu.

O corpo da requisição é maior do que o servidor permite (antes chamado “Payload Too Large”).

Quando usar: Uploads de arquivos acima do seu limite — ex.: client_max_body_size do nginx.

A URL é maior do que o servidor consegue interpretar.

Quando usar: Geralmente é um bug: query strings enormes ou loops de redirecionamento que continuam acrescentando parâmetros.

O formato do corpo (Content-Type) não é suportado.

Quando usar: Uma API que espera application/json recebe dados de formulário ou XML.

O cabeçalho Range pede bytes fora do arquivo.

Quando usar: Retomar um download a partir de um ponto além do fim de um arquivo que diminuiu de tamanho.

O servidor não consegue atender à exigência do cabeçalho Expect.

Quando usar: Rejeitar uploads com Expect: 100-continue.

Uma piada de 1º de abril da RFC 2324 (Hyper Text Coffee Pot Control Protocol): o servidor se recusa a preparar café porque é um bule de chá.

Quando usar: Apenas easter eggs. Alguns serviços o retornam para rejeitar requisições automatizadas ou indesejadas, mas ele não tem significado padrão.

A requisição chegou a um servidor que não consegue gerar uma resposta para este host.

Quando usar: Reuso de conexão HTTP/2 entre nomes de host cujo certificado ou configuração não corresponde.

A sintaxe é válida, mas o conteúdo falha na validação semântica.

Quando usar: Erros de validação em formulários ou APIs (campo obrigatório ausente, e-mail inválido). Popular em APIs Rails e Laravel.

WebDAV: o recurso está bloqueado.

Quando usar: Um arquivo está em edição ou bloqueado por outro usuário.

WebDAV: a requisição falhou porque uma requisição anterior da qual dependia também falhou.

Quando usar: Operações em lote em que uma falha cancela as demais.

O servidor não processará uma requisição que pode ser reproduzida (dados antecipados do TLS 1.3 / 0-RTT).

Quando usar: Proteger requisições não idempotentes enviadas nos dados antecipados do TLS contra ataques de repetição.

O cliente deve mudar para outro protocolo, indicado no cabeçalho Upgrade.

Quando usar: Forçar clientes a usar uma versão mais nova do protocolo.

O servidor exige que a requisição seja condicional (ex.: incluir If-Match).

Quando usar: Evitar “atualizações perdidas” recusando requisições PUT/PATCH incondicionais.

O cliente enviou requisições demais em um determinado período (limitação de taxa).

Quando usar: Limites de requisições de API e proteção contra força bruta. Inclua um cabeçalho Retry-After.

Impacto no SEO: O Googlebot reduz a taxa de rastreamento quando vê 429 (e 503). 429s persistentes podem levar à remoção de URLs.

Um cabeçalho (geralmente Cookie) ou todos os cabeçalhos juntos são grandes demais.

Quando usar: Geralmente causado por cookies acumulados; limpar os cookies do site resolve para o usuário.

O recurso está bloqueado por motivos legais — censura, ordens judiciais ou regulamentação regional. O número faz referência a Fahrenheit 451, de Ray Bradbury.

Quando usar: Conteúdo removido por pedido de remoção ou com acesso restrito por geolocalização por lei.

Impacto no SEO: Tratado como os demais códigos 4xx: não indexado.

Um erro genérico: o servidor encontrou uma condição inesperada.

Quando usar: Exceções não tratadas, scripts que falharam, regras do .htaccess quebradas. Verifique os logs do servidor.

Impacto no SEO: Quedas curtas são toleradas; se erros 5xx persistirem por dias, o Google reduz o rastreamento e, com o tempo, remove URLs.

O servidor não oferece a funcionalidade necessária (geralmente um método desconhecido).

Quando usar: Um método que o servidor não reconhece de forma alguma, diferente do 405 para um método conhecido, mas não permitido.

Um gateway ou proxy recebeu uma resposta inválida do servidor upstream.

Quando usar: Seu servidor de aplicação (PHP-FPM, Node, Gunicorn) travou ou retornou lixo atrás de um nginx, load balancer ou CDN.

Impacto no SEO: Igual aos demais 5xx: algo temporário é tolerável, erros persistentes prejudicam o rastreamento e a indexação.

O servidor está temporariamente incapaz de atender a requisição — sobrecarregado ou fora do ar para manutenção.

Quando usar: Manutenção programada ou sobrecarga. Adicione Retry-After para informar quando voltar.

Impacto no SEO: O código correto para indisponibilidade programada: o Google mantém a página indexada e tenta novamente depois. Não o mantenha por mais de um ou dois dias.

Um gateway ou proxy não recebeu resposta do servidor upstream a tempo.

Quando usar: Consultas lentas ao banco de dados ou APIs upstream que excedem o timeout do proxy.

Impacto no SEO: Timeouts persistentes reduzem a taxa de rastreamento e podem levar à desindexação.

O servidor não suporta a versão do HTTP usada na requisição.

Quando usar: Versões de protocolo muito antigas ou muito novas que o servidor não consegue tratar.

Erro de configuração do servidor: a variante escolhida também está configurada para negociar, criando um loop.

Quando usar: Um erro de configuração na negociação de conteúdo.

WebDAV: o servidor não consegue armazenar a representação necessária para concluir a requisição.

Quando usar: O disco ou a cota do usuário está cheio.

WebDAV: o servidor detectou um loop infinito ao processar a requisição.

Quando usar: Alguns hosts (ex.: cPanel/CloudLinux) também o retornam quando uma conta atinge seus limites de recursos.

São necessárias extensões adicionais à requisição (RFC 2774, agora histórica).

Quando usar: Praticamente não utilizado.

O cliente deve se autenticar para obter acesso à rede.

Quando usar: Portais cativos em Wi-Fi de hotéis, aeroportos ou cafés.

O nginx fecha a conexão sem enviar nenhuma resposta.

Quando usar: Configurado no nginx para descartar silenciosamente requisições maliciosas ou indesejadas.

Registrado pelo nginx quando o cliente fechou a conexão antes de o servidor responder.

Quando usar: Você verá isso nos logs quando usuários saem da página ou quando o timeout do cliente é menor que o tempo de resposta do seu servidor.

O Cloudflare recebeu do servidor de origem uma resposta vazia, desconhecida ou inesperada.

Quando usar: Travamentos na origem, cabeçalhos grandes demais ou conexões redefinidas. Verifique os logs de erro da origem.

Impacto no SEO: Tratado como um erro 5xx.

O servidor de origem recusou a conexão do Cloudflare.

Quando usar: O servidor web está parado ou um firewall bloqueia os intervalos de IP do Cloudflare.

Impacto no SEO: Tratado como um erro 5xx.

O Cloudflare não conseguiu concluir uma conexão TCP com a origem.

Quando usar: Origem sobrecarregada, registro DNS errado ou firewall descartando pacotes.

Impacto no SEO: Tratado como um erro 5xx.

O Cloudflare se conectou à origem, mas ela não respondeu em 100 segundos.

Quando usar: Requisições de longa duração; mova-as para tarefas em segundo plano.

Impacto no SEO: Tratado como um erro 5xx.

O handshake TLS entre o Cloudflare e a origem falhou.

Quando usar: A origem não tem um certificado válido ou não oferece suporte a SNI/às versões de TLS usadas pelo Cloudflare.

Impacto no SEO: Tratado como um erro 5xx.

O Cloudflare (no modo Full Strict) não conseguiu validar o certificado da origem.

Quando usar: Certificado de origem expirado ou autoassinado — instale um certificado válido ou um certificado Origin CA do Cloudflare.

Impacto no SEO: Tratado como um erro 5xx.