Referência de Códigos de Status HTTP
Os códigos de status HTTP são números de três dígitos que um servidor retorna em resposta à requisição de um cliente. O primeiro dígito define a categoria: 1xx informativo, 2xx sucesso, 3xx redirecionamento, 4xx erros do cliente e 5xx erros do servidor. Todo desenvolvedor web e consumidor de APIs encontra esses códigos diariamente, e saber o que significam reduz o tempo de depuração.
Como Usar
- Pesquise por número ou nome. Digite um código de status como “404” ou uma palavra-chave como “redirect” para filtrar a lista
- Filtre por categoria. Clique em uma aba de categoria para ver apenas códigos informativos, de sucesso, redirecionamento, erro de cliente ou erro de servidor
- Expanda um código. Clique em qualquer linha de código de status para ver a descrição detalhada
- Copie. Clique no botão de copiar para copiar o código é o nome para sua área de transferência
Entendendo as Categorias de Códigos de Status HTTP
1xx Informativo
Respostas provisórias. O servidor recebeu a requisição é o cliente deve continuar ou esperar. Raramente você os vê diretamente. O mais prático é 101 Switching Protocols, que é como HTTP faz upgrade para WebSocket.
2xx Sucessó
A requisição foi recebida, entendida e aceita. 200 OK é a resposta de sucessó padrão. 201 Created é a resposta correta para um POST que cria um novo recurso. 204 No Content é retornado para um DELETE bem-sucedido quando não há nada a retornar. Usar o código 2xx correto torna as APIs autodocumentadas.
3xx Redirecionamento
Mais ações são necessárias para completar a requisição, geralmente seguindo um cabeçalho Location. 301 e 308 são redirecionamentos permanentes (os motores de busca transferem o ranking). 302 e 307 são temporários (os motores de busca mantêm a URL original). A diferença entre os códigos pareados: 307/308 garantem a preservação do método, enquanto 301/302 podem trocar POST para GET.
4xx Erro do Cliente
A requisição contém algo errado. 400 Bad Request para sintaxe inválida. 401 Unauthorized para falta de autenticação. 403 Forbidden para permissão insuficiente. 404 Not Found para recursó inexistente. 429 Too Many Requests para raté limiting. A categoria 4xx é onde a maioria dos desenvolvedores passa a maior parte do tempo depurando.
5xx Erro do Servidor
O servidor falhou ao processar uma requisição válida. 500 Internal Server Error é o para-choques. 502 Bad Gateway e 504 Gateway Timeout indicam problemas de rede entre serviços. 503 Service Unavailable indica sobrecarga ou manutenção. Logs do servidor de aplicação são essenciais para diagnosticar 5xx.
Tabela de Referência Rápida
1xx Informativo
| Código | Nome | Descrição |
|---|---|---|
| 100 | Continue | Cliente deve continuar com a requisição |
| 101 | Switching Protocols | Servidor aceitou upgrade de protocolo |
| 102 | Processing | Servidor está processando (WebDAV) |
| 103 | Early Hints | Servidor está enviando headers antecipadamente |
2xx Sucessó | Código | Nome | Descrição |
|--------|------|-----------| | 200 | OK | Requisição bem-sucedida | | 201 | Created | Recursó criado com sucessó | | 202 | Accepted | Requisição aceita para processamento assíncrono | | 204 | No Content | Sucessó sem corpo de resposta | | 206 | Partial Content | Resposta parcial (range requests) |
3xx Redirecionamento
| Código | Nome | Descrição |
|---|---|---|
| 301 | Moved Permanently | Redirecionamento permanente |
| 302 | Found | Redirecionamento temporário |
| 303 | See Other | Redirecionar para GET após POST |
| 304 | Not Modified | Recursó não modificado (cache) |
| 307 | Temporary Redirect | Temporário, preserva método |
| 308 | Permanent Redirect | Permanente, preserva método |
4xx Erro do Cliente
| Código | Nome | Descrição |
|---|---|---|
| 400 | Bad Request | Erro de sintaxe na requisição |
| 401 | Unauthorized | Autenticação necessária |
| 403 | Forbidden | Sem permissão de acessó |
| 404 | Not Found | Recursó não encontrado |
| 405 | Method Not Allowed | Método HTTP não suportado |
| 409 | Conflict | Estado conflitante |
| 410 | Gone | Recursó removido permanentemente |
| 422 | Unprocessable Entity | Erro de válidação semântica |
| 429 | Too Many Requests | Raté limit excedido |
5xx Erro do Servidor
| Código | Nome | Descrição |
|---|---|---|
| 500 | Internal Server Error | Erro interno do servidor |
| 501 | Not Implemented | Funcionalidade não implementada |
| 502 | Bad Gateway | Resposta inválida do upstream |
| 503 | Service Unavailable | Serviço temporariamente indisponível |
| 504 | Gateway Timeout | Upstream não respondeu a tempo |
| 505 | HTTP Version Not Supported | Versão HTTP não suportada |