Consulta de Códigos de Status HTTP

Consulte qualquer código de status HTTP — 200, 404, 500 e tudo entre eles — com uma explicação em português simples do que significa e quando os servidores o retornam.

O que é Consulta de Códigos de Status HTTP?

Códigos de status HTTP são os números de três dígitos que um servidor web envia de volta em cada resposta, informando ao cliente (navegador, app ou consumidor de API) se a solicitação teve sucesso, precisa de um redirecionamento, ou falhou — e por quê. Eles são padronizados pela IETF e usados de forma idêntica em todo servidor web, navegador e linguagem de programação, o que os torna uma das referências de depuração mais universais no desenvolvimento de software.

Esta ferramenta de consulta cobre os códigos mais comumente encontrados nas cinco categorias — informativo (1xx), sucesso (2xx), redirecionamento (3xx), erro do cliente (4xx) e erro do servidor (5xx) — com explicações em português simples do que cada um realmente significa na prática, não apenas a definição formal da RFC.

Fórmula

1xx: Informativo — solicitação recebida, processo continuando

2xx: Sucesso — solicitação recebida e aceita com sucesso

3xx: Redirecionamento — ação adicional necessária para concluir a solicitação

4xx: Erro do Cliente — a solicitação contém sintaxe incorreta ou não pode ser atendida

5xx: Erro do Servidor — o servidor falhou ao atender uma solicitação válida

Como calcular

Digite um código de status (como 404) ou uma palavra-chave (como "proibido") na caixa de pesquisa.
Filtre por categoria usando os botões 1xx-5xx se quiser navegar por uma faixa específica.
Leia a descrição em português simples do que o código significa e quando é normalmente retornado.
Use isto como referência rápida ao depurar respostas de API ou construir tratamento de erros.

Exemplo

Pesquisar "429" retorna "Too Many Requests" — o código que as APIs retornam quando você excedeu um limite de taxa, indicando que deve desacelerar e tentar novamente após um atraso.

Benefícios Principais

Todo código de status comumente usado em uma única referência pesquisável
Explicações em português simples, não apenas o texto formal da RFC
Filtre instantaneamente por categoria (1xx a 5xx)
Gratuito, rápido, sem necessidade de cadastro

Erros Comuns a Evitar

Retornar 200 OK para uma solicitação que na verdade falhou, escondendo erros das ferramentas de monitoramento
Confundir 401 (não autenticado) com 403 (autenticado mas não autorizado)
Usar 302 para um redirecionamento que deveria ser permanente (301), prejudicando o SEO
Tratar todos os erros 4xx e 5xx da mesma forma no tratamento de erros do lado do cliente em vez de ramificar pelo código específico

Dicas Profissionais

Reserve códigos 5xx estritamente para falhas do lado do servidor — nunca os use para sinalizar erros de entrada do cliente
Use 429 com um cabeçalho Retry-After ao limitar taxa, para que clientes bem-comportados saibam quando tentar novamente
Prefira 404 a uma página de erro genérica sempre que um recurso genuinamente não existir — é melhor tanto para usuários quanto para mecanismos de busca
Ao projetar uma API, escolha códigos 4xx específicos (422, 409, 400) em vez de usar um 400 genérico para tudo

Termos Chave Explicados

Linha de status: A primeira linha de uma resposta HTTP, contendo o código de status e uma breve frase de razão
Idempotente: Uma propriedade de certos métodos HTTP em que repetir a mesma solicitação tem o mesmo efeito que fazê-la uma vez
Cadeia de redirecionamento: Uma sequência de múltiplos redirecionamentos que um navegador segue antes de chegar ao recurso final
Limitação de taxa: Restringir quantas solicitações um cliente pode fazer em uma determinada janela de tempo, frequentemente sinalizada com 429

Casos de uso comuns

Entender rapidamente um código de status desconhecido retornado por uma API com a qual você está integrando
Decidir qual código de status retornar da sua própria API para uma determinada condição de erro
Depurar por que uma solicitação está falhando, verificando o que um código específico realmente implica
Ensinar ou aprender fundamentos de HTTP em um curso de desenvolvimento web
Escrever lógica precisa de tratamento de erros que distingue entre diferentes casos 4xx e 5xx

Perguntas Frequentes

O que significam as diferentes faixas de código de status HTTP?

Códigos 1xx são informativos, 2xx significam sucesso, 3xx indicam redirecionamento, 4xx significam que o cliente cometeu um erro (como solicitar uma página inexistente), e 5xx significam que o próprio servidor falhou ao atender uma solicitação válida.

Qual a diferença entre 401 e 403?

401 Unauthorized significa que você não se autenticou (ou suas credenciais são inválidas) — o servidor não sabe quem você é. 403 Forbidden significa que o servidor sabe quem você é, mas você não tem permissão para acessar o recurso.

Por que às vezes vejo 200 para uma página que claramente falhou ao carregar?

Isso geralmente significa que o servidor retornou uma resposta HTTP válida (daí o 200 OK), mas o conteúdo em nível de aplicação dessa resposta descreve um erro — um padrão comum em APIs que colocam detalhes do erro no corpo da resposta em vez de no código de status.

Qual a diferença entre os redirecionamentos 301 e 302?

301 Moved Permanently instrui navegadores e mecanismos de busca a atualizarem seus registros e usarem a nova URL a partir de então. 302 Found sinaliza um redirecionamento temporário — a URL original ainda deve ser usada em solicitações futuras.