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.
- Digite o código, por exemplo 404, ou uma palavra como "redirecionamento" na caixa de busca.
- Leia o que o código significa, quando enviá-lo e qual RFC o define.
- Escolha uma classe como 4xx, ou limpe a caixa para ver todos os códigos agrupados por classe.
1xx · Informativos
Continue
O servidor recebeu os cabeçalhos da requisição e o cliente pode continuar e enviar o corpo.
Quando usar: Responde a uma requisição enviada com Expect: 100-continue, para que o cliente confira se um upload grande será aceito antes de enviá-lo.
Definido em RFC 9110 §15.2.1
Switching Protocols
O servidor concorda em mudar para o protocolo que o cliente pediu no cabeçalho Upgrade.
Quando usar: O que o servidor responde quando uma conexão passa para WebSocket, que é onde a maioria das pessoas o encontra.
Definido em RFC 9110 §15.2.2
Processing
Uma resposta provisória do WebDAV dizendo que o servidor recebeu a requisição e ainda está trabalhando nela.
Quando usar: Evitava que a conexão expirasse durante operações WebDAV longas. Foi retirado de especificações WebDAV posteriores e hoje quase não é enviado.
Definido em RFC 2518
Early Hints
Uma resposta provisória que envia alguns cabeçalhos, normalmente Link, antes de a resposta final ficar pronta.
Quando usar: Permite que o navegador comece a pré-carregar folhas de estilo e scripts enquanto o servidor ainda monta a página.
Definido em RFC 8297
2xx · Sucesso
OK
A requisição deu certo. O que o corpo contém depende do método: o recurso num GET, o resultado da ação num POST.
Quando usar: A resposta padrão para uma requisição que funcionou. Quando algo novo foi criado, 201 diz mais.
Definido em RFC 9110 §15.3.1
Created
A requisição deu certo e criou um ou mais recursos novos.
Quando usar: A resposta a um POST ou PUT que criou algo, com um cabeçalho Location apontando para o novo recurso.
Definido em RFC 9110 §15.3.2
Accepted
A requisição foi aceita para processamento, mas o processamento não terminou e ainda pode falhar.
Quando usar: Para trabalho que roda em segundo plano (uma tarefa na fila, uma importação em lote), de preferência com um link onde o cliente possa acompanhar o progresso.
Definido em RFC 9110 §15.3.3
Non-Authoritative Information
A requisição deu certo, mas um proxy no meio do caminho alterou a resposta que recebeu do servidor de origem.
Quando usar: Enviado por proxies que transformam conteúdo para dizer que ele não é exatamente o que a origem mandou. Raramente visto.
Definido em RFC 9110 §15.3.4
No Content
A requisição deu certo e a resposta, de propósito, não tem corpo.
Quando usar: Uma resposta comum a um DELETE, ou a um PUT quando o cliente não precisa de uma cópia de volta.
Definido em RFC 9110 §15.3.5
Reset Content
A requisição deu certo e o cliente deve redefinir a visualização que a enviou, como limpar um formulário.
Quando usar: Pensado para interfaces de entrada de dados que querem o formulário vazio para o próximo registro. Na prática os navegadores fazem pouco com ele.
Definido em RFC 9110 §15.3.6
Partial Content
O servidor está enviando só a parte do recurso que o cliente pediu num cabeçalho Range.
Quando usar: É assim que avançar num vídeo, retomar downloads e os gerenciadores de download buscam um arquivo em partes.
Definido em RFC 9110 §15.3.7
Multi-Status
Uma resposta WebDAV cujo corpo XML traz um status separado para cada um de vários recursos.
Quando usar: Para uma única requisição que agiu sobre muitos itens, em que alguns podem ter dado certo e outros não.
Definido em RFC 4918
Already Reported
Usado dentro de uma resposta WebDAV 207 para dizer que os membros de um recurso já foram listados antes na mesma resposta.
Quando usar: Evita repetir o mesmo item quando uma coleção pode ser alcançada por mais de um vínculo (binding).
Definido em RFC 5842
IM Used
O servidor atendeu um GET e a resposta é o resultado de manipulações de instância, como um delta, aplicadas ao recurso atual.
Quando usar: Faz parte da codificação delta do HTTP (RFC 3229), em que o cliente pede só o que mudou desde a sua cópia. Raramente implementado.
Definido em RFC 3229
3xx · Redirecionamento
Multiple Choices
O recurso tem várias representações, e o cliente ou o usuário deve escolher uma.
Quando usar: Pouco usado, porque não existe um jeito padrão de escolher automaticamente; os servidores costumam escolher uma e enviá-la.
Definido em RFC 9110 §15.4.1
Moved Permanently
O recurso tem um novo endereço permanente, informado no cabeçalho Location, e os links devem ser atualizados para ele.
Quando usar: Para uma página que mudou de vez. Os buscadores passam o ranqueamento para o novo endereço. Um cliente pode transformar um POST em GET ao segui-lo, então use 308 quando o método importar.
Definido em RFC 9110 §15.4.2
Found
Também conhecido como: Moved Temporarily
O recurso está temporariamente em outro endereço, informado no cabeçalho Location; o endereço original continua sendo o certo a usar.
Quando usar: Para uma mudança passageira, como mandar visitantes para uma página de login. Os clientes podem trocar POST por GET ao segui-lo; 307 proíbe isso.
Definido em RFC 9110 §15.4.3
See Other
A resposta está em outro endereço, e o cliente deve buscá-la com um GET.
Quando usar: A resposta clássica depois do POST de um formulário (Post/Redirect/Get), para que recarregar a página de resultado não envie o formulário de novo.
Definido em RFC 9110 §15.4.4
Not Modified
A cópia em cache do cliente continua atual, então o servidor não envia corpo.
Quando usar: A resposta a um GET condicional com If-None-Match ou If-Modified-Since quando nada mudou. Não é um erro: é o cache funcionando.
Definido em RFC 9110 §15.4.5
Use Proxy
Fora de usoAntigamente mandava o cliente repetir a requisição pelo proxy informado no cabeçalho Location.
Quando usar: Descontinuado por motivos de segurança, já que permitia a uma resposta desviar o tráfego por um proxy à sua escolha. Não o envie.
Definido em RFC 9110 §15.4.6
(Unused)
Fora de usoReservado. Um rascunho anterior o definia como Switch Proxy, e ele nunca foi usado.
Quando usar: Nunca o envie. O número continua reservado para não ser reaproveitado.
Definido em RFC 9110 §15.4.7
Temporary Redirect
O recurso está temporariamente no endereço do cabeçalho Location, e o cliente deve repetir a requisição lá com o mesmo método e o mesmo corpo.
Quando usar: O redirecionamento temporário a usar quando um POST precisa continuar sendo POST. As mudanças de http para https feitas pelo HSTS também aparecem nos navegadores como 307.
Definido em RFC 9110 §15.4.8
Permanent Redirect
O recurso mudou permanentemente para o endereço do cabeçalho Location, e o cliente deve manter o mesmo método e o mesmo corpo.
Quando usar: Um redirecionamento permanente para uma API ou qualquer endpoint que aceite POST ou PUT, em que um 301 poderia transformar a requisição em GET.
Definido em RFC 9110 §15.4.9
4xx · Erro do cliente
Bad Request
O servidor não consegue processar a requisição por algo que considera um erro do cliente, como sintaxe malformada.
Quando usar: Para uma requisição que nem pode ser interpretada: JSON quebrado, um cabeçalho inválido, um parâmetro obrigatório faltando.
Definido em RFC 9110 §15.5.1
Unauthorized
A requisição não tem credenciais de autenticação válidas para o recurso. Apesar do nome, trata de autenticação, não de permissão.
Quando usar: Quando o cliente não fez login ou o token dele expirou. A resposta precisa incluir um cabeçalho WWW-Authenticate dizendo como se autenticar.
Definido em RFC 9110 §15.5.2
Payment Required
Reservado para uso futuro. A especificação nunca definiu o que ele deve fazer.
Quando usar: Algumas APIs o enviam quando uma assinatura venceu ou um pagamento falhou, mas não há um comportamento padrão por trás.
Definido em RFC 9110 §15.5.3
Forbidden
O servidor entendeu a requisição e se recusa a atendê-la. Enviar as mesmas credenciais de novo não muda a resposta.
Quando usar: Quando se sabe quem é o usuário, mas ele não tem permissão: a conta de outra pessoa, uma página de administração, um país ou IP bloqueado.
Definido em RFC 9110 §15.5.4
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
Method Not Allowed
O servidor conhece o método, mas este recurso não o aceita.
Quando usar: Para um POST num endereço somente leitura, ou um DELETE onde nada pode ser apagado. A resposta precisa listar os métodos permitidos num cabeçalho Allow.
Definido em RFC 9110 §15.5.6
Not Acceptable
O servidor não consegue gerar uma resposta em nenhum formato que o cliente disse aceitar nos cabeçalhos Accept.
Quando usar: Uma negociação de conteúdo sem nada em comum, como um cliente que só aceita XML diante de uma API que só fala JSON. A maioria dos servidores envia o formato padrão no lugar.
Definido em RFC 9110 §15.5.7
Proxy Authentication Required
Como o 401, mas quem precisa que o cliente se autentique é um proxy entre o cliente e o servidor.
Quando usar: Enviado por proxies corporativos e outros proxies com autenticação, com um cabeçalho Proxy-Authenticate dizendo como.
Definido em RFC 9110 §15.5.8
Request Timeout
O servidor desistiu de esperar o cliente terminar de enviar a requisição.
Quando usar: Enviado numa conexão ociosa antes de o servidor fechá-la. O cliente pode simplesmente repetir a requisição numa conexão nova.
Definido em RFC 9110 §15.5.9
Conflict
A requisição entra em conflito com o estado atual do recurso.
Quando usar: Uma edição baseada numa versão desatualizada, um nome de usuário que já está em uso ou o upload de um arquivo cujo nome já existe.
Definido em RFC 9110 §15.5.10
Gone
O recurso esteve aqui e foi removido de propósito, sem endereço de encaminhamento.
Quando usar: Para conteúdo retirado de vez. Diz aos buscadores com mais firmeza que um 404 que a página não vai voltar.
Definido em RFC 9110 §15.5.11
Length Required
O servidor recusa uma requisição que tem corpo, mas não tem cabeçalho Content-Length.
Quando usar: Enviado por servidores que não aceitam uploads em partes (chunked) de tamanho desconhecido.
Definido em RFC 9110 §15.5.12
Precondition Failed
Uma condição nos cabeçalhos da requisição, como If-Match ou If-Unmodified-Since, não foi atendida.
Quando usar: Protege contra atualizações perdidas: o recurso mudou desde a última leitura do cliente, então a gravação é recusada.
Definido em RFC 9110 §15.5.13
Content Too Large
Também conhecido como: Payload Too Large, Request Entity Too Large
O corpo da requisição é maior do que o servidor quer ou consegue processar. A RFC 9110 mudou o nome, que antes era Payload Too Large.
Quando usar: Um upload acima do limite de tamanho. Se o limite for temporário, um cabeçalho Retry-After diz quando tentar de novo.
Definido em RFC 9110 §15.5.14
URI Too Long
Também conhecido como: Request-URI Too Long
A URI da requisição é mais longa do que o servidor está disposto a ler.
Quando usar: Normalmente um formulário enviado por GET com uma query string enorme, ou um loop de redirecionamento que foi aumentando a URL. Envie os dados no corpo de um POST.
Definido em RFC 9110 §15.5.15
Unsupported Media Type
O servidor recusa a requisição porque o corpo está num formato que ele não aceita.
Quando usar: Um Content-Type errado ou ausente, como dados de formulário enviados para um endpoint que só aceita application/json.
Definido em RFC 9110 §15.5.16
Range Not Satisfiable
Também conhecido como: Requested Range Not Satisfiable
Nenhum dos intervalos do cabeçalho Range da requisição coincide com o recurso.
Quando usar: Pedir bytes além do fim do arquivo, muitas vezes ao retomar o download de um arquivo que depois ficou menor.
Definido em RFC 9110 §15.5.17
Expectation Failed
O servidor não consegue atender à exigência do cabeçalho Expect da requisição.
Quando usar: Visto principalmente quando um proxy ou servidor não aceita Expect: 100-continue. Repetir sem esse cabeçalho costuma funcionar.
Definido em RFC 9110 §15.5.18
(Unused)
Fora de usoTambém conhecido como: I'm a teapot
O código de 1º de abril da RFC 2324: um bule de chá que se recusa a fazer café. A RFC 9110 reserva o número para que ele nunca ganhe um significado real.
Quando usar: Não é para produção. Alguns sites o enviam como easter egg ou para barrar bots, mas não dá para esperar que os clientes o entendam.
Definido em RFC 9110 §15.5.19
Misdirected Request
A requisição chegou a um servidor que não consegue gerar uma resposta para o host que ela indica.
Quando usar: Acontece principalmente com a reutilização de conexões do HTTP/2, quando uma conexão é compartilhada entre nomes de host para os quais o servidor não está configurado. O cliente deve tentar de novo numa conexão nova.
Definido em RFC 9110 §15.5.20
Unprocessable Content
Também conhecido como: Unprocessable Entity
O servidor entende o tipo de conteúdo e a sintaxe está correta, mas não consegue processar o que a requisição contém. Antes se chamava Unprocessable Entity.
Quando usar: A resposta comum para um erro de validação numa requisição bem formada. Faz parte do próprio HTTP desde a RFC 9110, não só do WebDAV.
Definido em RFC 9110 §15.5.21
Locked
O recurso WebDAV acessado está bloqueado.
Quando usar: Um arquivo que outro usuário bloqueou para edição.
Definido em RFC 4918
Failed Dependency
A requisição falhou porque outra ação da qual ela dependia falhou.
Quando usar: Num lote WebDAV, as operações que não puderam rodar porque uma anterior na mesma requisição falhou.
Definido em RFC 4918
Too Early
O servidor não quer arriscar processar uma requisição que pode ser reenviada por repetição.
Quando usar: Para requisições enviadas como early data do TLS 1.3 (0-RTT), que um atacante poderia repetir. O cliente deve tentar de novo quando o handshake terminar.
Definido em RFC 8470
Upgrade Required
O servidor recusa a requisição no protocolo atual, mas a aceitaria depois que o cliente mudasse de protocolo.
Quando usar: Enviado com um cabeçalho Upgrade indicando o protocolo exigido, por exemplo uma versão mais nova do HTTP ou do TLS.
Definido em RFC 9110 §15.5.22
Precondition Required
O servidor exige que a requisição seja condicional, com um cabeçalho como If-Match.
Quando usar: Obriga os clientes a provar qual versão estão alterando, para que duas edições não se sobrescrevam sem ninguém perceber.
Definido em RFC 6585
Too Many Requests
O cliente enviou requisições demais num determinado intervalo de tempo.
Quando usar: Limitação de taxa (rate limiting). Um cabeçalho Retry-After diz quanto esperar; os clientes devem espaçar as tentativas em vez de repetir na hora.
Definido em RFC 6585
Request Header Fields Too Large
O servidor não vai processar a requisição porque os cabeçalhos, ou um deles, são grandes demais.
Quando usar: Quase sempre um cookie enorme, ou cookies demais para um domínio. Limpar os cookies do site costuma resolver.
Definido em RFC 6585
Unavailable For Legal Reasons
O servidor está negando acesso ao recurso por causa de uma exigência legal.
Quando usar: Conteúdo bloqueado por ordem judicial, pedido do governo ou remoção num país. O número é uma referência ao romance Fahrenheit 451.
Definido em RFC 7725
5xx · Erro do servidor
Internal Server Error
O servidor encontrou uma condição inesperada que o impediu de atender a requisição.
Quando usar: O genérico para uma falha ou exceção não tratada. Os logs do próprio servidor dizem o que realmente aconteceu; o cliente normalmente não consegue resolver.
Definido em RFC 9110 §15.6.1
Not Implemented
O servidor não oferece a funcionalidade necessária para atender a requisição.
Quando usar: Um método que o servidor não reconhece de forma alguma. Ao contrário do 405, significa que nenhum recurso deste servidor o aceita.
Definido em RFC 9110 §15.6.2
Bad Gateway
Um servidor que atua como gateway ou proxy recebeu uma resposta inválida, ou nenhuma, do servidor por trás dele.
Quando usar: A aplicação por trás do nginx, de um balanceador de carga ou de uma CDN caiu, está reiniciando ou está inacessível.
Definido em RFC 9110 §15.6.3
Service Unavailable
O servidor não consegue atender a requisição agora, porque está sobrecarregado ou em manutenção.
Quando usar: Uma condição temporária. Envie um cabeçalho Retry-After dizendo quando voltar; os buscadores tratam um 503 como temporário e mantêm a página.
Definido em RFC 9110 §15.6.4
Gateway Timeout
Um servidor que atua como gateway ou proxy não recebeu a tempo uma resposta do servidor por trás dele.
Quando usar: Uma consulta lenta ao banco de dados ou um backend que demora mais que o tempo limite do proxy para responder.
Definido em RFC 9110 §15.6.5
HTTP Version Not Supported
O servidor não aceita a versão principal do HTTP usada na requisição.
Quando usar: Raro, já que quase todo servidor fala HTTP/1.1, HTTP/2 e muitas vezes HTTP/3.
Definido em RFC 9110 §15.6.6
Variant Also Negotiates
Um erro de configuração do servidor na negociação transparente de conteúdo: a variante escolhida também está configurada para negociar, o que criaria um loop.
Quando usar: Vem da negociação de conteúdo experimental (RFC 2295) e quase nunca é visto.
Definido em RFC 2295
Insufficient Storage
O servidor não consegue armazenar o que a requisição precisa que ele armazene.
Quando usar: Um upload ou cópia WebDAV quando o disco ou a cota do usuário está cheio.
Definido em RFC 4918
Loop Detected
O servidor interrompeu uma operação WebDAV porque encontrou um loop infinito.
Quando usar: Uma requisição com Depth: infinity através de vínculos (bindings) que apontam uns para os outros.
Definido em RFC 5842
Not Extended
Fora de usoA requisição precisa de extensões adicionais que o servidor exige antes de atendê-la.
Quando usar: Vem do HTTP Extension Framework (RFC 2774), que depois passou para status histórico, e o registro marca o código como obsoleto. Não o envie.
Definido em RFC 2774
Network Authentication Required
O cliente precisa se autenticar para ter qualquer acesso à rede.
Quando usar: Enviado por portais cativos, como as páginas de login do Wi-Fi de hotéis ou aeroportos, que interceptam o tráfego até o usuário entrar.
Definido em RFC 6585
Salvar esta ferramenta
Tenha Códigos de status HTTP sempre à mão
Use o menu Compartilhar do navegador e escolha “Adicionar à Tela Inicial”.
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.
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?
Você tem um rascunho não enviado.
Obrigado — recebemos sua mensagem. Você verá a resposta na sua caixa de entrada.Ir para minhas mensagens