Diagnosticar erro de API
Ao ver códigos como 401, 403, 409 ou 422, consulte rápido o significado e os contextos comuns.
Carregando…
Guide
A página de códigos de status HTTP é uma tabela de consulta embutida no aplicativo: dá para buscar por código, nome em inglês, significado ou descrição, e filtrar por 1xx informação, 2xx sucesso, 3xx redirecionamento, 4xx erro do cliente e 5xx erro do servidor. O conteúdo é conhecimento estático: nenhuma requisição HTTP é enviada ao domínio ou endpoint que você digitar.
Atualizado em 2026-09-102 min read
404, "timeout" ou o nome do status, ou deixe o campo vazio para navegar por tudo.| Entrada | Saída | Observação |
|---|---|---|
404 |
A ficha do 404 Not Found | Busca exata por número |
| "redirecionamento" | Descrições relacionadas de 3xx | Busca textual |
| Selecionar 5xx | Só a classe de erro do servidor | Filtro local |
HTTP_STATUS embutida no repositório; a cobertura acompanha a versão do aplicativo e não é sincronizada on-line com o registro da IANA.fetch, então não dá para saber qual código um site devolve neste momento.Ao ver códigos como 401, 403, 409 ou 422, consulte rápido o significado e os contextos comuns.
Navegue pelos grupos 2xx/3xx/4xx/5xx para fixar os conceitos básicos do protocolo.
Não. Esta página não tem nenhuma capacidade de rede; ela só consulta a tabela local de códigos.
Não, são dados embutidos na versão do aplicativo.
O termo buscado apenas filtra uma tabela estática no local; nenhuma requisição de rede é enviada.
Atualizado em 2026-09-10
Referência rápida de todos os códigos 1xx–5xx com significado e casos de uso
Esta ferramenta ainda não está totalmente traduzida; parte do conteúdo usa o idioma de origem ou um idioma de reserva.
O servidor recebeu os cabeçalhos da requisição e o cliente deve continuar enviando o corpo. Comum em uploads grandes precedidos por Expect: 100-continue.
O servidor aceita mudar de protocolo, geralmente no handshake do WebSocket (Upgrade: websocket).
Extensão WebDAV: a requisição foi recebida e está em processamento, mas ainda não há resposta. Evita que o cliente atinja o tempo limite.
Retorna parte dos cabeçalhos antes da resposta final, geralmente com um cabeçalho Link para o navegador pré-carregar recursos CSS/JS.
A requisição teve êxito. GET retorna o conteúdo do recurso, POST o resultado do processamento. O código mais comum.
O recurso foi criado com sucesso; comum após POST/PUT, geralmente com um cabeçalho Location apontando para o novo recurso.
A requisição foi aceita mas ainda não foi processada; indicado para tarefas assíncronas como filas e importações em massa.
Os metadados retornados vêm de uma cópia local ou de terceiros (por exemplo, de um proxy que os altera), e não do servidor de origem.
Processado com sucesso, mas sem conteúdo na resposta; comum após um DELETE bem-sucedido ou ao salvar um formulário sem redirecionar.
Processado com sucesso; o cliente deve redefinir a visualização (por exemplo, limpar um formulário). Raramente usado na prática.
Uma requisição de intervalo teve êxito e parte do recurso é retornada. A busca em vídeos e os downloads retomáveis dependem disso (cabeçalho Range).
Extensão WebDAV: uma requisição contém várias operações e o corpo XML informa o status de cada uma.
Extensão WebDAV: os membros vinculados já foram enumerados em uma resposta anterior e não são listados de novo.
O servidor concluiu a requisição GET do recurso e a resposta é o resultado da aplicação de manipulações de instância (codificação delta).
O recurso tem várias representações (como versões em outros idiomas) e o cliente ou usuário deve escolher uma.
O recurso foi movido permanentemente para um novo endereço e os mecanismos de busca atualizam o índice. Comum em troca de domínio e migração de HTTP para HTTPS.
O recurso está temporariamente em outro endereço. Em implementações antigas o cliente pode converter POST em GET; para manter o método, use 307.
O cliente deve buscar o resultado com GET em outro endereço; típico do redirecionamento para a página de resultado após enviar um formulário (padrão PRG).
O recurso não mudou desde a última requisição, então o cache local pode ser reutilizado. Funciona com ETag / Last-Modified.
(Obsoleto) Exige acessar o recurso pelo proxy indicado. Os navegadores modernos não suportam mais por motivos de segurança.
Como o 302, mas o método e o corpo da requisição não podem mudar no redirecionamento (POST continua POST).
Como o 301, mas mantém o método e o corpo da requisição; indicado para mover uma API permanentemente.
O servidor não consegue entender a requisição: parâmetro ausente, JSON malformado, sintaxe inválida. O cliente deve revisar a requisição.
Credenciais ausentes ou inválidas (por exemplo, token expirado). Semanticamente significa que o usuário não está conectado, então deve ser direcionado à autenticação.
Código reservado que algumas APIs usam para indicar cota esgotada ou necessidade de assinatura paga.
A identidade é conhecida, mas falta permissão para acessar o recurso (por exemplo, um usuário comum em uma interface administrativa). Diferente do 401, aqui é autorização.
O recurso solicitado não existe: URL incorreta ou recurso removido. O código mais conhecido.
O recurso não suporta esse método HTTP (por exemplo, POST em uma interface somente leitura). A resposta deve trazer o cabeçalho Allow com os métodos permitidos.
O servidor não consegue gerar um formato que atenda ao cabeçalho Accept (o cliente só aceita XML e o servidor só tem JSON).
Como o 401, mas é preciso autenticar-se primeiro no servidor proxy.
O servidor atingiu o tempo limite esperando o envio da requisição (rede lenta ou cliente interrompido). O cliente pode tentar novamente depois.
A requisição conflita com o estado atual do recurso: criação duplicada, edições simultâneas etc.
O recurso existiu, mas foi removido permanentemente e não voltará. É mais explícito que o 404 e ajuda os mecanismos de busca a removê-lo do índice.
O servidor exige que a requisição inclua o cabeçalho Content-Length.
Uma condição de cabeçalho como If-Match não foi atendida; usado em bloqueio otimista para impedir sobrescrever um recurso alterado por outra pessoa.
O corpo da requisição excede o limite do servidor, comum em uploads grandes demais (por exemplo, client_max_body_size do nginx).
A URL solicitada excede o comprimento aceito pelo servidor, geralmente por excesso de parâmetros GET; use POST.
O formato do corpo da requisição não é suportado, por exemplo, enviar um formulário para uma API que espera application/json.
O intervalo pedido no cabeçalho Range ultrapassa o tamanho real do recurso; comum quando o registro local de um download retomável não bate com o arquivo do servidor.
O servidor não consegue atender ao que o cabeçalho Expect exige (por exemplo, não suporta 100-continue).
Uma pegadinha de 1º de abril de 1998 (protocolo HTCPCP): o bule se recusa a fazer café. Alguns sites usam como resposta anti-scraper divertida.
A requisição chegou a um servidor que não consegue gerar resposta, geralmente por reutilização de conexão HTTP/2 para o host virtual errado.
A requisição está correta na sintaxe, mas inválida na semântica: a validação de um campo falhou (por exemplo, e-mail malformado). APIs REST usam para erros de formulário.
Extensão WebDAV: o recurso está bloqueado e a operação atual não pode ser executada.
Extensão WebDAV: como uma requisição anterior falhou, a atual também não pode ser concluída.
O servidor não quer processar dados iniciais que poderiam ser repetidos (TLS 1.3 0-RTT), evitando ataques de replay.
O servidor recusa processar com o protocolo atual e pede atualização ao cliente; o cabeçalho Upgrade indica o protocolo de destino.
O servidor exige um cabeçalho condicional (como If-Match) para forçar o uso de bloqueio otimista e evitar perda de atualizações.
O limite de requisições foi atingido. A resposta pode trazer Retry-After para indicar quando tentar novamente; é o código padrão de limitação de API.
O tamanho total dos cabeçalhos ou de um campo específico excede o limite, geralmente porque os cookies cresceram demais.
O recurso é negado por motivos legais (direitos autorais, bloqueio regulatório). O número homenageia o romance Fahrenheit 451.
O servidor encontrou um erro inesperado (exceção não capturada, bug). É preciso verificar os logs do servidor.
O servidor não suporta esse método ou recurso, por exemplo, PATCH em um servidor que só aceita GET/POST.
O gateway ou proxy reverso recebeu uma resposta inválida do servidor upstream; comum com backend fora do ar ou conexão upstream recusada pelo nginx.
O servidor está temporariamente sobrecarregado ou em manutenção; pode vir com Retry-After. Comum ao escalar, fazer deploy ou acionar o circuit breaker.
O gateway ou proxy atingiu o tempo limite aguardando o servidor upstream, geralmente por backend lento ou consulta lenta no banco de dados.
O servidor não suporta a versão do protocolo HTTP usada na requisição.
Erro de configuração da negociação de conteúdo: a variante escolhida participa da própria negociação, criando um loop.
Extensão WebDAV: o servidor não tem espaço suficiente para o que a requisição precisa armazenar (por exemplo, disco cheio).
Extensão WebDAV: um loop infinito foi detectado ao processar a requisição (por exemplo, um ciclo de vínculos).
A requisição não traz extensões exigidas pelo servidor; é preciso ampliá-la antes de tentar de novo (raríssimo).
É preciso autenticar-se na camada de rede antes de navegar; o caso típico é o portal cativo do Wi-Fi de hotel ou aeroporto.