Referência de Códigos de Estado HTTP
| Código | Nome | Significado |
|---|---|---|
| 100 | Continuar | O cliente deve continuar com o corpo do pedido |
| 101 | Mudança de Protocolos | Atualização de protocolo aceite (por ex., para WebSocket) |
| 200 | OK | O pedido teve sucesso — a resposta de sucesso predefinida |
| 201 | Criado | Foi criado um novo recurso (sucesso típico de POST) |
| 202 | Aceite | Em fila para processamento assíncrono, ainda não concluído |
| 204 | Sem Conteúdo | Sucesso com um corpo intencionalmente vazio |
| 301 | Movido Permanentemente | O recurso tem um novo URL permanente — atualize as ligações; o valor SEO transfere |
| 302 | Encontrado | Redirecionamento temporário (historicamente mal utilizado; ver 303/307) |
| 303 | Ver Outro | Redirecionar para um GET noutro URL (post/redirect/get) |
| 304 | Não Modificado | A cópia em cache ainda é válida — revalidar via ETag/Last-Modified |
| 307 | Redirecionamento Temporário | Redirecionamento temporário preservando método e corpo |
| 308 | Redirecionamento Permanente | Redirecionamento permanente preservando método e corpo |
| 400 | Pedido Inválido | O servidor não consegue analisar/compreender o pedido |
| 401 | Não Autorizado | Autenticação necessária ou falhou (apesar do nome, significa não autenticado) |
| 403 | Proibido | Autenticado ou não, o acesso é recusado |
| 404 | Não Encontrado | Nenhum recurso neste URL |
| 405 | Método Não Permitido | O método HTTP não é suportado para este recurso |
| 406 | Não Aceitável | Nenhuma representação corresponde aos cabeçalhos Accept |
| 408 | Tempo de Espera do Pedido Excedido | O cliente demorou demasiado a enviar o pedido |
| 409 | Conflito | Conflito de estado, por ex., colisão de edição ou criação duplicada |
| 410 | Removido Permanentemente | Removido permanentemente (mais forte do que 404 — utilizado deliberadamente) |
| 411 | Comprimento Obrigatório | O cabeçalho Content-Length é obrigatório |
| 413 | Conteúdo Demasiado Grande | O corpo do pedido excede os limites do servidor |
| 414 | URI Demasiado Longo | O URL excede os limites do servidor |
| 415 | Tipo de Media Não Suportado | O Content-Type do pedido não é suportado |
| 418 | Sou um Bule | Código de piada RFC 2324, ocasionalmente utilizado para recusar fazer café |
| 422 | Conteúdo Não Processável | A sintaxe está bem mas a semântica falha a validação (as APIs adoram esta) |
| 425 | Demasiado Cedo | Servidor não disposto a processar um pedido possivelmente repetido |
| 429 | Demasiados Pedidos | Limite de taxa atingido — recue, respeite o Retry-After |
| 500 | Erro Interno do Servidor | Falha genérica do lado do servidor |
| 501 | Não Implementado | O servidor não suporta a funcionalidade |
| 502 | Gateway Inválido | Um proxy/gateway recebeu uma resposta inválida do upstream |
| 503 | Serviço Indisponível | Sobrecarregado ou em baixo para manutenção — frequentemente temporário, pode trazer Retry-After |
| 504 | Tempo de Espera do Gateway Excedido | Um proxy/gateway excedeu o tempo de espera pelo upstream |
| 505 | Versão HTTP Não Suportada | A versão HTTP no pedido não é suportada |
Sobre
Os códigos de estado são o resumo de um número do servidor de cada resposta, agrupados por classe: 1xx informativo, 2xx sucesso, 3xx redirecionamento, 4xx o cliente errou, 5xx o servidor errou. A tabela dá os códigos que os programadores em atividade realmente encontram, com as nuances que importam na prática — 401 significa não autenticado apesar do seu nome, 403 é uma recusa independentemente do início de sessão, 422 é a falha de validação da API, 429 exige recuo. Códigos não listados (a cauda longa de 1xx e códigos experimentais) são raros o suficiente para que só a classe lhe diga como tratá-los.
Perguntas Frequentes
Qual é a diferença entre 401 e 403?
401: não sabemos quem é (autentique-se). 403: sabemos, e mesmo assim não pode.
302 ou 307 para um redirecionamento temporário?
O 307 preserva o método e o corpo; o 302 historicamente permitia aos clientes mudar POST para GET. Trabalho novo deve utilizar 307 (ou 308 para permanente).