Códigos de status HTTP: como ler respostas de 1xx a 5xx
Do 200 ao 503: encontre o código HTTP, entenda a classe da resposta e descubra o que conferir antes de concluir a causa do problema.
|
100 Continue
|
1 | 100 | Continue | Informativo | O cliente pode continuar a enviar o corpo da requisição. |
|---|---|---|---|---|---|
|
101 Switching Protocols
|
2 | 101 | Switching Protocols | Informativo | O servidor aceita trocar o protocolo solicitado. |
|
102 Processing
|
3 | 102 | Processing | Informativo | A requisição foi aceita e ainda está em processamento. |
|
200 OK
|
4 | 200 | OK | Sucesso | A requisição foi bem-sucedida. |
|
201 Created
|
5 | 201 | Created | Sucesso | Um novo recurso foi criado com sucesso. |
|
202 Accepted
|
6 | 202 | Accepted | Sucesso | A requisição foi aceita para processamento assíncrono. |
|
204 No Content
|
7 | 204 | No Content | Sucesso | Sucesso sem corpo de resposta. |
|
206 Partial Content
|
8 | 206 | Partial Content | Sucesso | Entrega parcial de conteúdo, comum em downloads. |
|
301 Moved Permanently
|
9 | 301 | Moved Permanently | Redirecionamento | O recurso mudou de URL de forma permanente. |
|
302 Found
|
10 | 302 | Found | Redirecionamento | Redirecionamento temporário para outra URL. |
|
304 Not Modified
|
11 | 304 | Not Modified | Redirecionamento | O conteúdo em cache ainda é válido. |
|
307 Temporary Redirect
|
12 | 307 | Temporary Redirect | Redirecionamento | Redirecionamento temporário mantendo o método HTTP. |
|
308 Permanent Redirect
|
13 | 308 | Permanent Redirect | Redirecionamento | Redirecionamento permanente mantendo o método HTTP. |
|
400 Bad Request
|
14 | 400 | Bad Request | Erro do cliente | A requisição está malformada ou incompleta. |
|
401 Unauthorized
|
15 | 401 | Unauthorized | Erro do cliente | Autenticação é necessária ou falhou. |
|
403 Forbidden
|
16 | 403 | Forbidden | Erro do cliente | O servidor entendeu, mas recusou a autorização. |
|
404 Not Found
|
17 | 404 | Not Found | Erro do cliente | O recurso solicitado não foi encontrado. |
|
405 Method Not Allowed
|
18 | 405 | Method Not Allowed | Erro do cliente | O método HTTP não é aceito neste recurso. |
|
408 Request Timeout
|
19 | 408 | Request Timeout | Erro do cliente | O servidor encerrou a espera pela requisição. |
|
409 Conflict
|
20 | 409 | Conflict | Erro do cliente | Conflito com o estado atual do recurso. |
|
410 Gone
|
21 | 410 | Gone | Erro do cliente | O recurso existiu, mas foi removido de forma permanente. |
|
415 Unsupported Media Type
|
22 | 415 | Unsupported Media Type | Erro do cliente | O formato do corpo não é suportado. |
|
422 Unprocessable Content
|
23 | 422 | Unprocessable Content | Erro do cliente | A sintaxe é compreensível, mas o conteúdo não atende às regras para processamento. |
|
429 Too Many Requests
|
24 | 429 | Too Many Requests | Erro do cliente | Limite de taxa de requisições foi excedido. |
|
500 Internal Server Error
|
25 | 500 | Internal Server Error | Erro do servidor | Falha genérica no servidor. |
|
501 Not Implemented
|
26 | 501 | Not Implemented | Erro do servidor | O servidor não implementa a funcionalidade pedida. |
|
502 Bad Gateway
|
27 | 502 | Bad Gateway | Erro do servidor | Resposta inválida de um gateway ou proxy. |
|
503 Service Unavailable
|
28 | 503 | Service Unavailable | Erro do servidor | Serviço temporariamente indisponível. |
|
504 Gateway Timeout
|
29 | 504 | Gateway Timeout | Erro do servidor | O gateway não recebeu resposta a tempo. |
|
511 Network Authentication Required
|
30 | 511 | Network Authentication Required | Erro do servidor | Autenticação de rede é necessária para prosseguir. |
Nenhum item combinou. Limpe um filtro ou encurte a busca.
O que os dados mostram
Explore as características dos itens e compare a distribuição de cada grupo.
Distribuição por Classe
Como ler este estudo
Os resultados descrevem os itens desta tabela. Em cada característica, os percentuais usam somente os registros com valor válido. As colunas são analisadas separadamente, e os resultados acompanham os filtros selecionados.
Sobre
O que um código HTTP realmente informa
O código de status é a primeira resposta curta que um servidor entrega depois de receber uma requisição. Ele não conta toda a história, mas separa rapidamente sucesso, redirecionamento, problema no pedido e falha no lado do serviço. A tabela reúne os códigos que mais aparecem em navegadores, APIs, logs e ferramentas de desenvolvimento.
Leia os três dígitos como uma classe antes de procurar o caso específico: 1xx é informativo, 2xx indica sucesso, 3xx trata de redirecionamento, 4xx aponta um problema ligado à requisição e 5xx indica falha durante o atendimento pelo servidor ou por algum componente intermediário.
O status não substitui o restante da resposta
Um código é um diagnóstico inicial, não uma explicação completa. Em uma API, confira o método usado, a URL, os cabeçalhos, o corpo de erro e o horário da tentativa. Um 400 pode vir de um campo ausente; um 401 pode indicar credencial vencida; um 429 pode exigir esperar o intervalo informado pela própria plataforma.
Também não é correto esperar sempre um JSON ou uma página HTML. A RFC 9110 estabelece que respostas 1xx, 204 e 304 não incluem conteúdo. Quando uma integração recebe 204 No Content, ela pode ter sido concluída com sucesso mesmo sem um corpo para exibir.
200, 201, 202 e 204: sucessos com efeitos diferentes
O 200 confirma que a requisição foi bem-sucedida, mas não descreve sozinho qual ação aconteceu. O 201 é adequado quando um recurso foi criado. O 202 indica que o servidor aceitou o trabalho, sem prometer que o processamento já terminou. Já o 204 informa sucesso sem conteúdo adicional na resposta.
Essa diferença ajuda a evitar interfaces enganosas. Um formulário que recebe 202 precisa comunicar que a tarefa ficou pendente; uma exclusão que retorna 204 não precisa tentar interpretar um corpo inexistente. A escolha correta depende do contrato da API, não apenas da preferência por um número conhecido.
Redirecionamentos: 301, 302, 307 e 308
Códigos 3xx pedem que o cliente considere outro endereço. O 301 e o 308 são usados para mudanças permanentes; o 302 e o 307, para mudanças temporárias. A diferença prática mais importante está em 307 e 308: eles deixam explícito que o método da requisição deve ser preservado.
O 304 merece leitura separada. Ele não significa que a página quebrou nem que o servidor recusou o pedido. Em uma requisição condicional, ele informa que a representação guardada em cache continua válida; por isso a resposta não traz um novo corpo.
Como investigar um 4xx sem adivinhar
Erros 4xx geralmente apontam para algo que o cliente pode revisar. Comece conferindo caminho, método e parâmetros. Depois valide autenticação, permissão, formato do corpo e limites de uso. Essa ordem evita a troca aleatória de credenciais quando o problema real é uma URL digitada com rota errada ou um POST enviado a um recurso que aceita apenas GET.
- 401 pede autenticação válida; 403 indica recusa de acesso mesmo depois de o servidor compreender a requisição.
- 404 informa que o recurso não foi encontrado; 410 comunica que ele existiu, mas foi removido.
- 405 aponta método não aceito; 415 aponta tipo de mídia não suportado.
- 422 Unprocessable Content aparece quando a sintaxe é compreensível, mas o conteúdo não atende às regras necessárias para processá-lo.
- 429 indica que o limite de requisições foi excedido; respeite a política e os cabeçalhos da fonte antes de repetir a chamada.
Quando 5xx aponta para servidor, gateway ou dependência
Um 500 é uma falha genérica durante o processamento. Um 502 sugere que um gateway ou proxy recebeu uma resposta inválida de outro componente. Um 503 costuma apontar indisponibilidade temporária, enquanto um 504 informa que o gateway não recebeu resposta a tempo. Os quatro merecem ações diferentes, embora todos estejam na faixa de erro do servidor.
Antes de repetir a mesma chamada muitas vezes, registre o horário, o código e qualquer identificador de requisição retornado. Isso dá ao responsável pelo serviço informação concreta para investigar e evita confundir uma oscilação externa com um erro de validação da aplicação cliente.
Como usar a tabela em desenvolvimento e suporte
Pesquise pelo número quando ele aparece em um log e filtre pela classe para enxergar padrões. Se vários endpoints retornam 502 ou 504 no mesmo período, a investigação tende a seguir para proxy ou serviço de origem. Se apenas uma rota retorna 404, comece pela URL, pelo ambiente e pelo caminho publicado.
Para testar respostas reais de serviços públicos, o catálogo de APIs do DexBase oferece consultas diretas. Use a documentação de cada fonte para saber quais status ela declara no próprio contrato.
Fonte de referência e limite desta lista
Os códigos HTTP evoluem por especificação e registro. A referência normativa para a semântica geral é a RFC 9110; a IANA mantém o registro de códigos. Esta tabela destaca os casos mais recorrentes, não substitui a documentação específica de uma API ou framework.
Perguntas frequentes
204 é erro?
Não. O 204 indica que a requisição foi atendida e que não há conteúdo adicional para enviar no corpo da resposta.
Qual a diferença entre 404 e 410?
O 404 diz que o recurso não foi encontrado naquele momento. O 410 informa que ele existiu, mas foi removido de forma permanente.
502 e 504 são a mesma coisa?
Não. O 502 indica resposta inválida de um componente intermediário ou de origem; o 504 indica que o gateway esperou e não recebeu resposta a tempo.



