📡 Códigos de Status HTTP
Referência pesquisável de todos os códigos de status HTTP com significados claros, agrupados por classe.
📚 Uma referência prática do dia a dia, não um substituto das especificações RFC. As descrições são curtas e úteis para depuração.
Como usar esta ferramenta
Visão geral
Códigos de Status HTTP é uma referência completa e pesquisável de todos os códigos de status HTTP padrão. Os códigos são agrupados por classe, 1xx informativo, 2xx sucesso, 3xx redirecionamento, 4xx erros do cliente e 5xx erros do servidor, cada um com um significado curto pensado para depuração. Digite qualquer número, nome ou palavra na busca e a lista filtra na hora: tente 404, redirect, timeout ou cache. Útil para depurar backends, projetar APIs, auditorias de SEO e suporte. Tudo carrega estaticamente e a busca roda localmente.Ler as classes de códigos de status
O primeiro dígito indica a responsabilidade. 1xx é provisório, requisição recebida, processamento em curso. 2xx significa sucesso, com 200 e 204 como casos comuns. 3xx indica movimento ou cache: 301 permanente, 302 temporário, 304 não modificado. 4xx significa que o cliente enviou algo não atendível: 400 malformado, 401 não autenticado, 403 proibido, 404 ausente, 429 limitado. 5xx significa falha do servidor: 500, 502, 503, 504.
Especificações técnicas
| Propriedade | Comportamento |
|---|---|
| Cobertura | Todos os códigos padrão agrupados por classe 1xx: 5xx |
| Descrições | Explicações claras voltadas à depuração |
| Busca | Filtragem instantânea por número, nome ou palavra |
| Carregamento | Referência estática, busca local |
| Custo | Grátis, sem conta e sem anúncios |
Notas práticas de depuração
- 404 vs. 410: gone indica remoção definitiva.
- 401 precisa de credenciais; 403 significa que não bastam.
- 502 e 504 geralmente apontam upstream ou proxy, não o seu código.
- Respostas 429 devem incluir Retry-After, respeite.
- 301 é cacheado agressivamente: teste em perfil limpo.
Veja também as ferramentas de desenvolvimento para cabeçalhos, SSL, DNS e OpenGraph.
Códigos de status em APIs e cache
Códigos de status carregam significado além de sucesso ou falha, e usar o correto evita que clientes adivinhem. Na faixa 2xx, 200 significa sucesso normal, 201 deve seguir a criação de um recurso e incluir cabeçalho Location, e 204 sinaliza sucesso sem corpo, útil para exclusões e atualizações sem retorno. Na faixa 3xx as distinções importam: 301 é mudança permanente que navegadores e buscadores cacheiam, 302 é temporária, e 307 e 308 preservam método e corpo HTTP, o que importa em redirecionamentos POST onde 301 ou 302 poderiam transformar silenciosamente a requisição em GET. Um 304 não é redirecionamento, mas resposta de cache: diz ao cliente que a cópia em cache ainda é válida. Na faixa 4xx, 400 é requisição malformada, 401 autenticação ausente ou inválida, 403 autenticado sem permissão, 404 recurso inexistente, 409 conflito como chave duplicada, 422 é comum para falhas de validação, e 429 pede que o cliente desacelere, de preferência com cabeçalho Retry-After. Na faixa 5xx, 500 é erro não tratado, 502 resposta ruim do upstream, 503 indisponibilidade temporária e 504 timeout do upstream. Duas regras de design decorrem: torne retentativas seguras mantendo GET, PUT e DELETE idempotentes, e nunca retorne 200 com um objeto de erro dentro, porque todo cliente tratará como sucesso. A referência roda no seu navegador.
Perguntas frequentes
O que é um código de status HTTP? +
Um número de três dígitos enviado pelo servidor em cada resposta para indicar como a requisição terminou. O primeiro dígito define a classe: 1xx informativo, 2xx sucesso, 3xx redirecionamento, 4xx erro do cliente e 5xx erro do servidor. O Códigos de Status HTTP lista todos com significados claros.
Qual a diferença entre 401 e 403? +
401 Unauthorized significa que a autenticação está ausente ou falhou, o cliente deve entrar e tentar de novo. 403 Forbidden significa que o servidor sabe quem você é, mas você não tem permissão, então repetir com as mesmas credenciais não ajudará.
Quais códigos uma API REST deve retornar? +
Mapeamentos típicos: 200 para leituras, 201 para criações com header Location, 204 para exclusões bem-sucedidas, 400 para validação, 401 e 403 para autenticação, 404 para recursos desconhecidos, 409 para conflitos e 429 para limite de taxa.
A lista é pesquisável? +
Sim, digite qualquer código, nome ou palavra na busca e a página filtra na hora, tudo localmente no navegador.