Pular para o conteúdo
helpyself

Códigos de status HTTP

Só local — nada é enviado a menos que você salve ou compartilhe.

Todos os códigos de status HTTP, o que significam e quando enviá-los, com a RFC que os define.

  1. Digite o código, por exemplo 404, ou uma palavra como "redirecionamento" na caixa de busca.
  2. Leia o que o código significa, quando enviá-lo e qual RFC o define.
  3. Escolha uma classe como 4xx, ou limpe a caixa para ver todos os códigos agrupados por classe.

4xx · Erro do cliente

404

Not Found

O servidor não tem nada neste endereço, ou não quer dizer se tem.

Quando usar: A resposta para um link quebrado ou uma URL digitada errado. Também é usado no lugar de 403 para esconder que um recurso privado existe. Se ele sumiu de vez, 410 diz isso.

Definido em RFC 9110 §15.5.5

Salvar esta ferramenta

Tenha Códigos de status HTTP sempre à mão

Favoritar
Incorporar

Coloque Códigos de status HTTP no seu site

Cole isto na sua página. Mostra a ferramenta, de graça, com um link para ela.

Prévia

Sobre esta ferramenta

Todos os códigos de status HTTP do registro oficial da IANA, de 100 Continue a 511 Network Authentication Required, cada um com uma explicação clara do que significa, quando um servidor deve enviá-lo e um link para a seção da RFC que o define. Digite um número, o primeiro dígito de uma classe ("4" ou "4xx") ou uma palavra como "redirecionamento" ou "limite", e a lista vai filtrando enquanto você digita. As diferenças que importam estão explicadas, em vez de deixadas para o nome. 401 Unauthorized significa que a requisição não foi autenticada (faça login e tente de novo), enquanto 403 Forbidden significa que o servidor entendeu a requisição e mesmo assim diz não. Com 301 e 302, um cliente antigo pode transformar um POST em GET a caminho do novo endereço; 308 e 307 são esses mesmos dois redirecionamentos com a garantia de que o método se mantém. 422 Unprocessable Content não é mais um extra do WebDAV: a RFC 9110 o incorporou ao HTTP em 2022, e por isso ele é a resposta comum para um erro de validação. Os nomes são mantidos exatamente como a especificação os escreve, porque é isso que aparece na linha de status, nos seus logs e em qualquer biblioteca. Quando um código mudou de nome (413 era Payload Too Large, 422 era Unprocessable Entity), o nome antigo também aparece, e a busca o encontra. 418 I'm a teapot também está aqui, marcado pelo que é: uma piada de 1º de abril da RFC 2324 que a RFC 9110 agora reserva para que ninguém dê ao número uma função real. Códigos não oficiais, como o 499 do nginx ou os 520 a 526 da Cloudflare, não estão no registro e não aparecem como se estivessem. Tudo roda no seu navegador e funciona offline depois que a página carrega.

Perguntas frequentes

Qual é a diferença entre 401 e 403?

401 Unauthorized significa que a requisição não tem credenciais válidas: o servidor não sabe quem você é e precisa informar como se autenticar em um cabeçalho WWW-Authenticate. Fazer login pode resolver. 403 Forbidden significa que o servidor entendeu a requisição e a recusa mesmo assim: repeti-la com as mesmas credenciais não adianta, só uma conta com a permissão certa resolveria. Apesar do nome, 401 trata de autenticação e 403 de permissão.

Devo usar 301 ou 308 para um redirecionamento permanente?

Para uma página web os dois funcionam, e 301 é o que todo rastreador e navegador trata há décadas; os buscadores tratam os dois da mesma forma. A diferença está no método. Com 301, um cliente antigo pode transformar um POST em GET ao seguir o redirecionamento, enquanto 308 garante que o método e o corpo continuam exatamente iguais. Para um endpoint de API que aceita POST ou PUT, use 308. O par temporário funciona do mesmo jeito: 302 pode mudar o método, 307 não pode.

O que significa 304 Not Modified?

Ele responde a uma requisição condicional, enviada com If-None-Match ou If-Modified-Since, e diz que a cópia que o cliente já tem continua atual, então nenhum corpo é enviado. É assim que o cache economiza banda, e não é um erro: ver muitos 304 nos seus logs significa que o cache está funcionando.

Para um erro de validação, o certo é 422 ou 400?

Use 400 quando a requisição nem pode ser lida: JSON quebrado, um cabeçalho obrigatório faltando. Use 422 Unprocessable Content quando ela está bem formada, mas o conteúdo não pode ser processado, como um campo de e-mail com algo que não é um endereço de e-mail. O 422 nasceu no WebDAV e foi incorporado ao próprio HTTP pela RFC 9110 em 2022, então não é mais uma extensão.

Qual é a diferença entre 502, 503 e 504?

Os três costumam vir de um proxy ou balanceador de carga, não da sua aplicação. 502 Bad Gateway significa que o servidor por trás enviou uma resposta inválida ou nenhuma, muitas vezes porque caiu. 503 Service Unavailable significa que o servidor está no ar, mas não consegue atender a requisição agora, por sobrecarga ou manutenção, de preferência com um cabeçalho Retry-After. 504 Gateway Timeout significa que o servidor por trás do proxy demorou demais para responder.

418 I'm a teapot é um código de status de verdade?

Começou como piada: a RFC 2324, uma RFC de 1º de abril de 1998, o definiu para cafeteiras que recebem um pedido de café, mas são bules de chá. Nunca foi feito para ser implementado, mas tantos frameworks o adicionaram que a RFC 9110 agora marca o 418 como reservado, para que o número não possa ganhar um significado real. Usá-lo em produção é uma piada que os clientes da sua API precisam entender.

Por que 499, 509 e 520 não aparecem?

Eles não são códigos de status HTTP registrados. O nginx registra 499 quando o cliente fechou a conexão antes da resposta, 509 Bandwidth Limit Exceeded vem de algumas empresas de hospedagem e 520 a 526 são erros próprios da Cloudflare para problemas ao alcançar o servidor de origem. Cada um só significa algo naquele produto, então a lista fica no registro oficial.

Ajude a melhorar esta ferramenta

Encontrou um bug, quer mudar algo ou precisa de uma ferramenta que não temos?

/http-status-codes

↑↓ para navegar · Enter para abrir · Esc para fechar