WebGroundwebground.app
Info e Guias · Referência Web

Referência de Códigos de Status HTTP

Guia pesquisável para códigos HTTP 1xx–5xx, significados e dicas práticas de depuração para APIs e CDNs.

Exibindo 26 códigos
100

Continue

Cabeçalhos iniciais recebidos; o cliente pode enviar o corpo da requisição.

Dica: Comum ao enviar payloads grandes com o cabeçalho Expect: 100-continue.

101

Switching Protocols

O servidor concordou em atualizar o protocolo, geralmente de HTTP para WebSocket.

Dica: Verifique os cabeçalhos Upgrade e Connection se o handshake WebSocket travar.

200

OK

Resposta padrão confirmando que a requisição HTTP teve sucesso.

Dica: Confira Content-Type e a estrutura JSON se o cliente ainda falhar ao renderizar.

201

Created

A requisição teve sucesso e criou um ou mais novos recursos.

Dica: APIs REST normalmente enviam um cabeçalho Location com a URL do novo recurso.

204

No Content

Requisição bem-sucedida, e o servidor retornou corpo vazio intencionalmente.

Dica: Evite chamar response.json() em respostas 204 (comum em DELETE ou OPTIONS).

206

Partial Content

O servidor entregou apenas o intervalo de bytes solicitado.

Dica: Usado por players de vídeo e downloads retomáveis via cabeçalhos Range.

301

Moved Permanently

O recurso mudou permanentemente para outra URL; buscadores transferem a autoridade SEO.

Dica: Navegadores armazenam 301 agressivamente em cache — teste regras novas em aba anônima ou curl -I.

302

Found (Redirecionamento temporário)

O recurso é servido temporariamente de outra URL mantendo a original indexada.

Dica: Frequente em fluxos de login OAuth ou rotas temporárias de manutenção.

304

Not Modified

A cópia em cache continua válida com base em ETag ou Last-Modified.

Dica: Economiza banda em estáticos; confira Cache-Control se arquivos antigos persistirem.

307

Temporary Redirect

Redirecionamento temporário que preserva estritamente método HTTP e corpo.

Dica: Use 307 em vez de 302 quando um POST precisar continuar sendo POST após redirecionar.

308

Permanent Redirect

Redirecionamento permanente que preserva método HTTP e corpo originais.

Dica: Muito usado em redirecionamentos de barra final no Next.js e HTTPS canônico.

400

Bad Request

O servidor não pôde processar a requisição por sintaxe malformada ou parâmetros inválidos.

Dica: Valide o JSON, campos obrigatórios na query e o cabeçalho Content-Type.

401

Unauthorized

Autenticação ausente, expirada ou inválida para o endpoint solicitado.

Dica: Verifique expiração do token Bearer, prefixo da chave de API ou cookies de sessão.

403

Forbidden

A identidade é conhecida (ou bloqueada por política), mas não há permissão de acesso.

Dica: Revise papéis RBAC, regras CORS/WAF ou permissões de bucket.

404

Not Found

O servidor não encontra a rota ou recurso solicitado.

Dica: Confira barras finais, caminho base, DNS ou IDs de recursos removidos.

405

Method Not Allowed

O endpoint existe, mas não aceita o método HTTP utilizado (ex.: GET em vez de POST).

Dica: Inspecione o cabeçalho Allow para ver quais métodos HTTP são aceitos.

408

Request Timeout

O cliente demorou demais para concluir o envio antes do servidor fechar o socket.

Dica: Investigue uploads lentos em rede móvel ou desajuste de keep-alive.

409

Conflict

A requisição conflita com o estado atual do recurso de destino.

Dica: Comum em cadastro com e-mail duplicado ou incompatibilidade de ETag.

413

Content Too Large

O payload da requisição excede o limite de tamanho do servidor ou proxy reverso.

Dica: Comprima imagens no cliente antes do upload ou aumente o limite do proxy.

415

Unsupported Media Type

O servidor recusa o formato declarado no cabeçalho Content-Type.

Dica: Garanta que Content-Type: application/json ou multipart/form-data corresponda ao corpo.

422

Unprocessable Content

A sintaxe é válida (ex.: JSON válido), mas os valores falharam na validação semântica.

Dica: Veja os detalhes do erro para e-mails inválidos, quantidades negativas ou campos faltantes.

429

Too Many Requests

O cliente excedeu o limite de requisições da API.

Dica: Respeite o cabeçalho Retry-After e aplique backoff exponencial com jitter.

500

Internal Server Error

Ocorreu uma exceção inesperada não tratada no servidor de origem.

Dica: Confira logs de stack trace, variáveis de ambiente ausentes ou falhas no banco.

502

Bad Gateway

Proxy, CDN ou balanceador recebeu resposta inválida do servidor upstream.

Dica: Verifique se o processo upstream está ativo e ouvindo na porta esperada.

503

Service Unavailable

Servidor temporariamente sobrecarregado ou em manutenção programada.

Dica: Verifique cabeçalhos Retry-After, falhas de health-check ou limites de cold start.

504

Gateway Timeout

Proxy ou CDN atingiu o tempo limite aguardando resposta do upstream.

Dica: Otimize consultas lentas ou mova tarefas pesadas para filas assíncronas.

Depurando um erro 400 Bad Request ou JSON de API agora mesmo?Abrir formatador JSON

Entendendo as cinco classes de códigos HTTP

Toda resposta HTTP começa com um código de três dígitos definido na RFC 9110. Agrupá-los pelo primeiro dígito ajuda desenvolvedores, DevOps e equipes de SEO a diagnosticar problemas rapidamente.

De modo geral: 1xx sinaliza negociação de protocolo, 2xx confirma sucesso, 3xx indica cache ou redirecionamento, 4xx aponta erro na requisição do cliente e 5xx indica falha no servidor de origem ou upstream.

Armadilhas comuns de status HTTP em produção

Conhecer a diferença entre códigos próximos evita bugs difíceis de rastrear:

  • 401 Unauthorized vs. 403 Forbidden: 401 indica credenciais ausentes ou expiradas; 403 indica identidade reconhecida (ou bloqueio por política), porém sem permissão.
  • 301/302 vs. 307/308: redirecionamentos legados 301/302 podem converter POST em GET, enquanto 307 e 308 preservam método e corpo originais.
  • 502 Bad Gateway vs. 504 Gateway Timeout: 502 indica resposta inválida do servidor upstream e 504 significa tempo limite esgotado aguardando resposta.

Perguntas Frequentes

Qual é a diferença entre 401 e 403?+

401 Unauthorized indica autenticação ausente, expirada ou inválida. 403 Forbidden significa que o servidor recusou a autorização por permissão ou política.

Como os clientes devem tratar o erro 429 Too Many Requests?+

Leia o cabeçalho Retry-After quando presente e tente novamente usando backoff exponencial com jitter aleatório.

Por que 204 No Content quebra response.json() em JavaScript?+

Respostas 204 vêm com corpo vazio por padrão; chamar response.json() gera erro de fim inesperado. Verifique response.status === 204 antes.

Explorar mais no WebGround

Ver tudo