Skip to content

Códigos de estado HTTP explicados

Todos os códigos de estado HTTP comuns, agrupados por classe: o que significam e quando os vê. O companheiro de consulta rápida da ferramenta HTTP Status Codes.

Os códigos de estado HTTP seguem um padrão: o primeiro dígito nomeia a classe e o resto é detalhe. 1xx é informativo, 2xx é sucesso, 3xx é redirecionamento, 4xx é erro do cliente e 5xx é falha do servidor. Leia primeiro o primeiro dígito. A ferramenta companheira permite consultar um único código em profundidade.

Tabela de referência · 55 entradasAbrir a ferramenta http-status-codes →
55 of 55 rows
1xx Informativo
ContinueO servidor recebeu os cabeçalhos do pedido e o cliente pode enviar o corpo.Após uma verificação prévia antes de enviar um corpo grande.
Switching ProtocolsO servidor concorda em mudar para o protocolo que o cliente pediu.Atualizar uma ligação HTTP para WebSocket.
ProcessingO servidor recebeu o pedido e continua a trabalhá-lo.Um servidor WebDAV a acusar um pedido longo para o cliente não expirar.
Early HintsO servidor envia cabeçalhos preliminares antes de a resposta final estar pronta.Deixar um navegador pré-carregar recursos enquanto a página ainda é composta.
2xx Sucesso
OKO pedido teve sucesso e o corpo da resposta traz o resultado.O sucesso padrão de um GET ou PUT.
CreatedO pedido teve sucesso e um novo recurso foi criado.Devolver após um POST bem-sucedido que cria algo.
AcceptedO pedido foi aceite para processamento mas ainda não terminou.Um trabalho longo começou e corre de forma assíncrona.
Non-Authoritative InformationO pedido teve sucesso mas os dados devolvidos foram transformados no caminho de volta.Um proxy ou cache a servir metadados modificados em vez dos da origem.
No ContentO pedido teve sucesso e não há corpo para devolver.Um DELETE com sucesso, ou um PUT sem nada a dizer.
Reset ContentO pedido teve sucesso e o cliente deve repor a vista que o enviou.Após submeter um formulário, dizer à página para limpar os campos.
Partial ContentO servidor devolve apenas parte do recurso, conforme pedido.Servir um intervalo de bytes de um pedido Range.
3xx Redirecionamento
Moved PermanentlyO recurso tem um novo URL permanente e os pedidos futuros devem usá-lo.Uma página mudou e os motores de busca devem atualizar o índice.
FoundO recurso está temporariamente num URL diferente, mas mantenha o original.Redirecionar para uma página de sessão por um momento.
See OtherA resposta vive noutro URL e deve ser obtida com um GET.O padrão PRG: redirecionar um POST para uma página de resultado para um refresh não reenviar.
Not ModifiedA cópia em cache continua válida, pelo que o servidor não envia corpo.GET condicional onde a cache do cliente está atualizada.
Use ProxyO pedido deve ser enviado através do proxy indicado na resposta.Redes legadas de proxy; obsoleto desde 2011.
Temporary RedirectO recurso está temporariamente noutro sítio e o método do pedido original deve ser preservado.Como o 302, mas um POST continua POST no redirecionamento.
Permanent RedirectO recurso tem um novo URL permanente e o método do pedido original deve ser preservado.Como o 301, mas um POST continua POST no redirecionamento.
4xx Erro do cliente
Bad RequestO servidor não compreendeu o pedido devido a sintaxe malformada.JSON malformado, ou um campo obrigatório em falta.
UnauthorizedA autenticação é necessária e faltou ou falhou.Sem token, ou token inválido ou expirado.
Payment RequiredO pedido exige pagamento, embora a especificação nunca tenha definido como.Algumas APIs usam-no como marcador de paywall; a maioria nunca o usa.
ForbiddenO cliente está autenticado mas não pode aceder a este recurso.Sessão válida, mas sem permissão para este recurso.
Not FoundO servidor não tem recurso neste URL.URL desconhecido ou um ID que não existe.
Method Not AllowedO URL existe mas não aceita o método usado no pedido.Um POST contra um endpoint que só aceita GET.
Not AcceptableO servidor não pode devolver conteúdo que corresponda aos cabeçalhos Accept do cliente.O cliente pediu só XML, mas a API só devolve JSON.
Proxy Authentication RequiredO cliente tem de autenticar-se no proxy antes de o pedido prosseguir.Um proxy corporativo a rejeitar um pedido não autenticado.
Request TimeoutO cliente demorou demasiado a enviar o pedido e o servidor desistiu.Um envio que parou antes de o corpo chegar ao fim.
ConflictO pedido conflitua com o estado atual do recurso.Um email duplicado ou uma corrida de edições no mesmo registo.
GoneO recurso existiu uma vez mas foi removido definitivamente.Um endpoint retirado de propósito, mais forte que o 404.
Length RequiredO pedido precisa de um cabeçalho Content-Length e não o tem.Um servidor que precisa de saber o tamanho antecipadamente a rejeitar um corpo em fluxo.
Precondition FailedUma pré-condição de cabeçalho, como If-Match, avaliou a falso.Uma edição otimista em que o registo mudou desde a leitura do cliente.
Content Too LargeO corpo do pedido excede o limite que o servidor aceita.Um envio maior que o tamanho máximo de corpo do servidor.
URI Too LongO URL do pedido é mais longo do que o servidor está disposto a interpretar.Um formulário serializado por acidente numa query string de GET que cresceu sem limite.
Unsupported Media TypeO formato do corpo do pedido não é um que o endpoint aceite.Um POST com Content-Type text/plain contra um endpoint só de JSON.
Range Not SatisfiableO intervalo de bytes no cabeçalho Range não cabe no recurso.Pedir bytes além do fim de um ficheiro ao retomar um download.
Expectation FailedO servidor não consegue cumprir a expectativa declarada no cabeçalho Expect.Uma expectativa 100-continue que o servidor se recusa a honrar.
I'm a teapotO servidor é um bule de chá e recusa fazer café.Uma piada de 1 de abril de 1998 que não morre; as APIs devolvem-no por diversão.
Misdirected RequestO pedido foi enviado a um servidor que não lhe pode produzir resposta.Uma ligação reutilizada enviada a um host que este servidor não serve.
Unprocessable EntityO pedido está bem formado mas os seus valores falham a validação semântica.JSON válido cujos campos violam regras de negócio.
Too EarlyO servidor recusa um pedido que arrisca ser uma repetição.Rejeitar um pedido não idempotente repetido antes de as chaves rodarem.
Upgrade RequiredO cliente tem de mudar para um protocolo diferente para usar este recurso.Um endpoint que insiste em TLS ou WebSocket.
Precondition RequiredO servidor exige cabeçalhos condicionais que o pedido não enviou.Uma API que exige If-Match para evitar atualizações perdidas.
Too Many RequestsO cliente enviou demasiados pedidos numa janela de tempo.Um limite de taxa foi atingido; recue e tente de novo.
Request Header Fields Too LargeUm ou mais campos de cabeçalho são grandes demais para o servidor processar.Um cookie ou token que cresceu até bloquear todos os pedidos ao site.
Unavailable For Legal ReasonsO recurso está bloqueado por razões legais, como uma retirada ou uma restrição geográfica.Uma retirada governamental ou uma página bloqueada num país.
5xx Erro do servidor
Internal Server ErrorO servidor atingiu uma condição inesperada e falhou.Uma exceção não tratada ou um bug no servidor.
Not ImplementedO servidor não suporta o método ou funcionalidade pedida.Um endpoint declarado mas ainda não construído.
Bad GatewayUm gateway ou proxy recebeu uma resposta inválida de um servidor a montante.Um proxy inverso que não alcançou o backend.
Service UnavailableO servidor está temporariamente incapaz de tratar o pedido.Manutenção, sobrecarga, ou um serviço dependente em baixo.
Gateway TimeoutUm gateway ou proxy não obteve resposta a tempo de um servidor a montante.O backend demorou demasiado e o proxy desistiu.
HTTP Version Not SupportedO servidor não suporta a versão HTTP do pedido.Um cliente a falar uma versão de protocolo que o servidor nunca aprendeu.
Variant Also NegotiatesA negociação transparente de conteúdo terminou numa referência circular.Um servidor mal configurado a fazer negociação experimental de conteúdo.
Insufficient StorageO servidor não consegue guardar a representação necessária para completar o pedido.Um servidor WebDAV cujo armazenamento atribuído está cheio.
Loop DetectedO servidor entrou num ciclo infinito ao processar o pedido.Um binding WebDAV que se refere a si próprio.
Network Authentication RequiredO cliente tem de autenticar-se na rede para obter acesso.Um portal cativo num hotel ou aeroporto a intercetar o pedido.