Referência de Códigos de Status HTTP
Os códigos de status HTTP são números de três dígitos retornados por um servidor web para indicar o resultado de uma requisição do cliente. Eles são agrupados em cinco classes: respostas informativas 1xx, códigos de sucesso 2xx, redirecionamentos 3xx, erros do cliente 4xx e erros do servidor 5xx. Entender esses códigos é essencial para depurar APIs, aplicações web e requisições de rede.
Esta referência cobre todos os códigos de status HTTP mais utilizados, definidos na RFC 9110 e especificações relacionadas. Use a caixa de busca para filtrar instantaneamente os códigos por número ou palavra-chave — útil ao diagnosticar problemas em logs de servidor, ferramentas de desenvolvedor do navegador ou respostas de API.
Como funciona
Os códigos de status HTTP seguem uma classificação estruturada: 1xx = informativo (requisição recebida, processando), 2xx = sucesso (requisição recebida, entendida e aceita), 3xx = redirecionamento (ação adicional necessária), 4xx = erro do cliente (sintaxe incorreta ou requisição não pode ser atendida), 5xx = erro do servidor (servidor falhou em atender uma requisição válida).
Casos de uso
- Depurar respostas de APIs REST e entender mensagens de erro
- Configurar redirecionamentos em servidores web (301, 302, 307, 308)
- Diagnosticar falhas de autenticação e autorização (401, 403)
- Identificar problemas de limitação de taxa e capacidade em produção (429, 503)
- Construir clientes HTTP e tratar cenários específicos de resposta programaticamente
Perguntas frequentes
Qual é a diferença entre os erros 401 e 403?
O 401 Unauthorized significa que a requisição não tem credenciais de autenticação válidas — o servidor não sabe quem você é, e fazer login pode resolver. O 403 Forbidden significa que o servidor sabe quem você é, mas se recusa a conceder acesso àquele recurso. Em resumo: 401 é um problema de autenticação, 403 é um problema de autorização.
O que significa o erro 500 Internal Server Error?
O erro 500 indica que o servidor encontrou uma condição inesperada ao processar uma requisição válida — normalmente uma exceção não tratada, uma configuração incorreta ou uma dependência de backend que falhou. É uma falha genérica do lado do servidor, então a correção cabe ao operador do site ou da API, não ao cliente. Verificar os logs do servidor costuma ser o primeiro passo da depuração.
Qual é a diferença entre redirecionamentos 301 e 302?
O 301 Moved Permanently informa a clientes e mecanismos de busca que o recurso tem uma nova URL permanente, então os navegadores fazem cache e os buscadores transferem os sinais de ranqueamento. O 302 Found sinaliza uma mudança temporária, indicando que a URL original deve continuar sendo usada no futuro. Para SEO, use 301 em mudanças permanentes de URL e 302 apenas em situações realmente temporárias.
Por que estou recebendo o erro 429 Too Many Requests?
O 429 significa que você excedeu o limite de requisições que o servidor permite para seu cliente, chave de API ou endereço IP em uma janela de tempo. Muitas APIs incluem um cabeçalho Retry-After informando quanto tempo esperar antes de tentar novamente. As soluções comuns são adicionar intervalos entre requisições, implementar backoff exponencial ou solicitar um limite maior.
Qual é a diferença entre os erros 502, 503 e 504?
Os três são erros do lado do servidor, comuns atrás de proxies e balanceadores de carga. O 502 Bad Gateway significa que um servidor upstream retornou uma resposta inválida, o 503 Service Unavailable indica que o servidor está temporariamente sobrecarregado ou em manutenção, e o 504 Gateway Timeout significa que um servidor upstream demorou demais para responder. Geralmente indicam problemas de infraestrutura, e não um erro na sua requisição.