Códigos de status HTTP
Todos os códigos de status HTTP registrados na IANA, com o significado em português. Pesquise pelo número ou por uma palavra e abra a página dos códigos mais usados para ver causas e como resolver.
Pesquisar
Códigos
| Código | Nome | Grupo | Significado |
|---|
Como os códigos se organizam
O primeiro dígito indica o grupo: 1xx informativos, 2xx sucesso, 3xx redirecionamento, 4xx erro atribuído ao cliente e 5xx erro do servidor. Códigos de um mesmo grupo seguem a mesma ideia geral, e um cliente que não conhece um código específico deve tratá-lo como o código "x00" do grupo (por exemplo, um 499 desconhecido é tratado como 400).
Os códigos que mais aparecem
- 200 OK: OK
- 201 Created: Criado
- 204 No Content: Sem conteúdo
- 301 Moved Permanently: Movido permanentemente
- 302 Found: Encontrado
- 304 Not Modified: Não modificado
- 400 Bad Request: Requisição inválida
- 401 Unauthorized: Não autenticado
- 403 Forbidden: Proibido
- 404 Not Found: Não encontrado
- 405 Method Not Allowed: Método não permitido
- 409 Conflict: Conflito
- 422 Unprocessable Content: Conteúdo não processável
- 429 Too Many Requests: Excesso de requisições
- 500 Internal Server Error: Erro interno do servidor
- 502 Bad Gateway: Gateway inválido
- 503 Service Unavailable: Serviço indisponível
- 504 Gateway Timeout: Tempo do gateway esgotado
Erro do cliente ou do servidor?
Códigos 4xx dizem que a requisição enviada tem algo a corrigir: autenticação, permissão, formato ou dados. Códigos 5xx dizem que o servidor falhou ao atender uma requisição que, em princípio, estava correta. Quem consome uma API deve corrigir o 4xx e repetir com espera o 5xx, e quem mantém o servidor precisa olhar os logs quando vê muitos 5xx.
Como ver o código de uma requisição
No navegador, abra as ferramentas de desenvolvedor (tecla F12), vá para a aba Rede (Network) e recarregue a página: cada linha mostra o código de status da requisição. No terminal, o comando curl -I endereço mostra só os cabeçalhos da resposta, com o código na primeira linha. Em redirecionamentos (3xx), confira o cabeçalho Location, que diz para onde ir; em 401, o WWW-Authenticate; em 405, o Allow; e em 429 e 503, o Retry-After.
De onde vêm os dados
Os códigos, os nomes em inglês e as referências vêm do registro oficial da IANA (Internet Assigned Numbers Authority), que lista os códigos de status HTTP atribuídos. Os nomes e as explicações em português são do Me Ajuda Flow. Registros temporários, que expiram, ficam de fora da tabela.
Perguntas frequentes
Qual a diferença entre 401 e 403?
No 401, o servidor não sabe quem você é: falta autenticação válida. No 403, ele sabe quem você é e se recusa a atender: falta permissão.
Quando usar 400 e quando usar 422?
Use 400 quando a requisição está malformada. Use 422 quando o formato está certo, mas o conteúdo não pode ser processado, como uma data inexistente.
Existem códigos que não estão na tabela?
Sim, algumas aplicações usam códigos não padronizados (como o 499 de alguns servidores). A tabela mostra só os registrados na IANA.
A tabela envia o que eu digito a algum servidor?
Não. A busca roda no seu navegador.