2xx · Sucesso
200
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
201
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
202
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
203
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
204
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
205
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
206
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
207
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
208
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
226
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
300
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
301
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
302
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
303
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
304
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
305
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
306
(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
307
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
308
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
400
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
401
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
402
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
403
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
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
405
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
406
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
407
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
408
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
409
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
410
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
411
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
412
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
413
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
414
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
415
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
416
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
417
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
418
(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
421
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
422
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
423
Locked
O recurso WebDAV acessado está bloqueado.
Quando usar: Um arquivo que outro usuário bloqueou para edição.
Definido em RFC 4918
424
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
425
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
426
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
428
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
429
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
431
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
451
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
500
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
501
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
502
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
503
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
504
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
505
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
506
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
507
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
508
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
510
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
511
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