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.
Guia pesquisável para códigos HTTP 1xx–5xx, significados e dicas práticas de depuração para APIs e CDNs.
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.
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.
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.
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.
Requisição bem-sucedida, e o servidor retornou corpo vazio intencionalmente.
Dica: Evite chamar response.json() em respostas 204 (comum em DELETE ou OPTIONS).
O servidor entregou apenas o intervalo de bytes solicitado.
Dica: Usado por players de vídeo e downloads retomáveis via cabeçalhos Range.
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.
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.
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.
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.
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.
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.
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.
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.
O servidor não encontra a rota ou recurso solicitado.
Dica: Confira barras finais, caminho base, DNS ou IDs de recursos removidos.
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.
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.
A requisição conflita com o estado atual do recurso de destino.
Dica: Comum em cadastro com e-mail duplicado ou incompatibilidade de ETag.
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.
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.
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.
O cliente excedeu o limite de requisições da API.
Dica: Respeite o cabeçalho Retry-After e aplique backoff exponencial com jitter.
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.
Proxy, CDN ou balanceador recebeu resposta inválida do servidor upstream.
Dica: Verifique se o processo upstream está ativo e ouvindo na porta esperada.
Servidor temporariamente sobrecarregado ou em manutenção programada.
Dica: Verifique cabeçalhos Retry-After, falhas de health-check ou limites de cold start.
Proxy ou CDN atingiu o tempo limite aguardando resposta do upstream.
Dica: Otimize consultas lentas ou mova tarefas pesadas para filas assíncronas.
| Código | Status | Significado | Dica de depuração | Copiar |
|---|---|---|---|---|
| 100 | Continue | Cabeçalhos iniciais recebidos; o cliente pode enviar o corpo da requisição. | 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. | 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. | 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. | 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. | Evite chamar response.json() em respostas 204 (comum em DELETE ou OPTIONS). | |
| 206 | Partial Content | O servidor entregou apenas o intervalo de bytes solicitado. | 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. | 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. | 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. | 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. | 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. | 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. | 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. | 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. | 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. | 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). | 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. | 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. | 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. | 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. | 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. | 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. | 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. | 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. | Verifique se o processo upstream está ativo e ouvindo na porta esperada. | |
| 503 | Service Unavailable | Servidor temporariamente sobrecarregado ou em manutenção programada. | 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. | Otimize consultas lentas ou mova tarefas pesadas para filas assíncronas. |
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.
Conhecer a diferença entre códigos próximos evita bugs difíceis de rastrear:
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.
Leia o cabeçalho Retry-After quando presente e tente novamente usando backoff exponencial com jitter aleatório.
Respostas 204 vêm com corpo vazio por padrão; chamar response.json() gera erro de fim inesperado. Verifique response.status === 204 antes.
Tabelas pesquisáveis de tamanhos de papel ISO e EUA, conversões métricas/imperiais, fusos horários mundiais e formatos de imagem web.
Entenda como funcionam Tesouro Selic, Tesouro IPCA+, CDBs atrelados ao CDI e como o efeito dos juros compostos multiplica aportes mensais.
Compare a Tabela Price (parcelas fixas) com o sistema SAC (parcelas decrescentes) e veja como amortizar o saldo devedor com FGTS ou recursos próprios.