Uma lista rápida e pesquisável de códigos de status HTTP
Toda vez que um navegador, aplicativo móvel ou crawler de busca faz uma requisição a um servidor web, o servidor responde com um número de três dígitos. Esses códigos de status HTTP informam ao cliente exatamente o que aconteceu: se a requisição foi bem-sucedida, falhou, exige autenticação ou precisa ser redirecionada.
Esta ferramenta oferece um dicionário completo e pesquisável de códigos de resposta HTTP padrão, com base nas especificações oficiais RFC. Como a lista inteira é carregada e filtrada localmente no seu navegador, a busca é instantânea. Você não precisa esperar a página recarregar para consultar a diferença entre um 301 e um 302, ou para descobrir o que significa um erro 422.
As cinco classes de códigos de resposta HTTP
Os códigos HTTP são agrupados em cinco classes distintas, definidas pelo seu primeiro dígito. Entender essas categorias é a maneira mais rápida de diagnosticar problemas de tráfego na web:
1xx (Informativos)
Esses códigos indicam que o servidor recebeu a requisição e está continuando o processo. São respostas temporárias, e o cliente deve aguardar uma resposta final. Por exemplo, 100 Continue diz ao cliente para prosseguir e enviar o corpo da requisição.
2xx (Sucesso)
Um código 2xx significa que a requisição do cliente foi recebida, compreendida e aceita com sucesso. O mais comum é o 200 OK, que é a resposta padrão para uma requisição HTTP bem-sucedida. Ao criar um novo registro via API, você pode ver um 201 Created.
3xx (Redirecionamento)
Esses códigos dizem ao cliente que uma ação adicional é necessária para concluir a requisição. Isso geralmente significa que o recurso solicitado foi movido. Um 301 Moved Permanently diz aos mecanismos de busca para atualizarem seus links, enquanto um 302 Found indica uma mudança temporária.
4xx (Erro do Cliente)
Códigos de erro HTTP na faixa 4xx significam que o problema está do lado do cliente. A requisição pode conter sintaxe incorreta, não possuir autenticação adequada ou solicitar um recurso que não existe. Esses erros são comuns quando os usuários digitam URLs incorretamente ou quando integrações de API enviam dados mal formatados.
5xx (Erro do Servidor)
Um código 5xx significa que o servidor falhou ao atender a uma requisição válida. O cliente fez tudo certo, mas o servidor encontrou um problema interno, travou ou está sobrecarregado no momento.
Códigos de erro HTTP comuns que você deve conhecer
Embora existam dezenas de códigos, apenas alguns representam a grande maioria dos erros que você encontrará como desenvolvedor ou webmaster:
O código de status 404 (Not Found)
Talvez o erro mais famoso da internet, o código de status 404 significa que o servidor não conseguiu encontrar o recurso solicitado. Para donos de sites, monitorar erros 404 é crucial para o SEO, pois links quebrados frustram os usuários e desperdiçam o crawl budget.
400 Bad Request
O servidor não pode processar a requisição devido a um erro do cliente, como sintaxe malformada ou roteamento inválido. APIs frequentemente retornam isso quando falta um parâmetro obrigatório.
401 Unauthorized e 403 Forbidden
Ambos lidam com acesso. Um 401 Unauthorized significa que o cliente deve se autenticar para obter a resposta solicitada (ex.: falta da chave de API). Um 403 Forbidden significa que a identidade do cliente é conhecida, mas ele não tem as permissões necessárias para acessar o recurso.
500 Internal Server Error
Este é um erro genérico para falhas no servidor. Significa que o servidor encontrou uma condição inesperada que o impediu de atender à requisição. Quando você vê um erro 500, geralmente precisa verificar os logs da aplicação do servidor para encontrar a causa raiz.
502 Bad Gateway e 503 Service Unavailable
Um 502 Bad Gateway ocorre quando um servidor atuando como proxy (como Nginx ou um balanceador de carga) recebe uma resposta inválida do servidor upstream. Um 503 Service Unavailable significa que o servidor está indisponível no momento para lidar com a requisição, geralmente por estar sobrecarregado ou em manutenção.
Melhores práticas para o desenvolvimento de APIs
Ao desenvolver uma API REST, retornar os códigos de status HTTP corretos é essencial para uma boa experiência do desenvolvedor. Retornar um 200 OK quando um erro realmente ocorreu (prática muitas vezes chamada de "engolir" erros) força os clientes a analisar manualmente o corpo da resposta para descobrir se a requisição realmente foi bem-sucedida.
Use esta referência para escolher o código semanticamente mais correto. Por exemplo, use 429 Too Many Requests quando um usuário atingir o limite de requisições (rate limit), ou 422 Unprocessable Content quando o payload JSON for válido, mas falhar na validação das regras de negócio.
Se você estiver investigando problemas de roteamento no servidor, nossa ferramenta de Consulta DNS também pode ser útil para verificar os registros do domínio, ou o Analisador de User-Agent para entender os clientes que estão fazendo requisições ao seu servidor. Se você está tentando gerenciar como os mecanismos de busca rastreiam seu site para evitar erros 404, experimente o Gerador de Robots.txt.