O que é Consulta de Códigos de Status HTTP?
Os 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, aplicativo ou consumidor de API) se a solicitação foi bem-sucedida, precisa de um redirecionamento ou falhou — e por quê. Eles são padronizados pela IETF e usados de forma idêntica em todos os servidores web, navegadores e linguagens 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 — informativos (1xx), sucesso (2xx), redirecionamento (3xx), erro do cliente (4xx) e erro do servidor (5xx) — com explicações em linguagem simples do que cada um realmente significa na prática, e não apenas a definição formal da RFC.
Quando Usar Esta Calculadora
- Depurar uma integração de API em que uma solicitação está falhando e você precisa entender o que o código de status realmente significa
- Decidir qual código de status HTTP retornar da sua própria API para uma condição de erro específica
- Ensinar ou aprender os fundamentos de HTTP em um curso ou bootcamp de desenvolvimento web
- Escrever middleware de tratamento de erros que precisa distinguir entre diferentes casos de 4xx e 5xx
- Investigar por que um redirecionamento não está funcionando verificando se 301 ou 302 foi retornado
- Solucionar problemas de CORS em que o navegador mostra um erro de rede, mas o servidor retornou 200
Passos:
- Digite um código de status (como 404) ou uma palavra-chave (como "forbidden") 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 linguagem simples do que o código significa e quando ele é normalmente retornado.
- Use isso como uma referência rápida ao depurar respostas de API ou ao criar tratamento de erros.
Fórmula
1xx: Informativo — solicitação recebida, processo em andamento
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
Casos de uso
- 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 os fundamentos de HTTP em um curso de desenvolvimento web
- Escrever lógica precisa de tratamento de erros que distingue entre diferentes casos de 4xx e 5xx
Benefícios Principais
- Todos os códigos de status comuns em uma única referência pesquisável
- Explicações em linguagem simples, não apenas terminologia formal da RFC
- Filtre instantaneamente por categoria (de 1xx a 5xx)
- Grátis, rápido e sem necessidade de cadastro
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 aplicar limite de taxa, para que clientes bem comportados saibam quando tentar novamente
- Prefira 404 em vez de uma página de erro genérica sempre que um recurso genuinamente não existir — é melhor para usuários e mecanismos de busca
- Ao projetar uma API, escolha códigos 4xx específicos (422, 409, 400) em vez de usar por padrão um 400 genérico para tudo
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 sem autorização)
- 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
Termos Chave Explicados
- Linha de status: A primeira linha de uma resposta HTTP, contendo o código de status e uma curta frase de motivo
- 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 vários redirecionamentos que um navegador segue antes de chegar ao recurso final
- Limite de taxa: Restringir quantas solicitações um cliente pode fazer em uma determinada janela de tempo, muitas vezes sinalizado com 429
Conceitos relacionados
- Formatador de JSON:
- Validador de JSON:
- Testador de Regex:
- Codificador/decodificador de URL:
- Codificador/decodificador Base64:
Exemplo
Pesquisar "429" retorna "Too Many Requests" — o código que as APIs retornam quando você excede um limite de taxa, informando para desacelerar e tentar novamente após um intervalo.
Interpretação dos seus resultados
Os códigos de status HTTP são agrupados em cinco classes pelo seu primeiro dígito. Os 1xx são informativos e raramente vistos em código de aplicação. Os 2xx confirmam sucesso — 200 OK é o mais comum, mas 201 Created e 204 No Content também são frequentes em APIs REST. Os 3xx lidam com redirecionamento, sendo 301 (permanente) e 302 (temporário) os mais importantes.
Erros 4xx indicam que algo está errado com a solicitação do cliente. Os mais comuns são 400 Bad Request (sintaxe malformada), 401 Unauthorized (não autenticado), 403 Forbidden (sem autorização), 404 Not Found (o recurso não existe) e 429 Too Many Requests (limite de taxa excedido). O uso correto de códigos 4xx específicos torna sua API muito mais fácil de depurar do que retornar um 400 genérico para tudo.
Erros 5xx significam que o servidor falhou. 500 é o erro interno genérico, 502 Bad Gateway indica um problema no servidor upstream e 503 Service Unavailable geralmente significa que o servidor está sobrecarregado ou fora do ar para manutenção. Ao depurar erros 5xx, verifique os logs do servidor em vez da resposta no lado do cliente, pois o código de status sozinho raramente revela a causa raiz.