Referência de códigos de status HTTP

Consulte o que significa um código de status HTTP.

1xx Informativo
100ContinueA parte inicial da requisição foi recebida e o cliente deve continuar enviando o restante dela.
101Switching ProtocolsO servidor está trocando de protocolo conforme solicitado pelo cliente, por exemplo, fazendo upgrade para WebSocket.
102ProcessingO servidor aceitou a requisição completa, mas ainda não terminou de processá-la (WebDAV).
103Early HintsPermite que o cliente comece a pré-carregar recursos enquanto o servidor ainda prepara a resposta final.
2xx Sucesso
200OKA requisição foi bem-sucedida e o corpo da resposta contém o recurso solicitado.
201CreatedA requisição foi bem-sucedida e, como resultado, um novo recurso foi criado.
202AcceptedA requisição foi aceita para processamento, mas o processamento ainda não foi concluído.
203Non-Authoritative InformationOs metadados retornados não vêm do servidor de origem, mas de uma cópia de terceiros ou do cache local.
204No ContentA requisição foi bem-sucedida, mas não há conteúdo para retornar.
205Reset ContentA requisição foi bem-sucedida; o cliente deve redefinir a visualização do documento que a enviou.
206Partial ContentApenas parte do recurso está sendo entregue, correspondendo a uma requisição de intervalo de bytes.
207Multi-StatusTransmite informações sobre múltiplos recursos em situações em que vários códigos de status podem ser apropriados (WebDAV).
208Already ReportedOs membros de uma vinculação WebDAV já foram listados em uma parte anterior da resposta.
226IM UsedO servidor atendeu a uma requisição usando uma ou mais manipulações de instância.
3xx Redirecionamento
300Multiple ChoicesA requisição tem mais de uma resposta possível; o cliente deve escolher uma delas.
301Moved PermanentlyO recurso foi movido permanentemente para uma nova URL fornecida na resposta.
302FoundO recurso está temporariamente em uma URL diferente; requisições futuras ainda devem usar a URL original.
303See OtherA resposta pode ser encontrada em outra URL usando uma requisição GET.
304Not ModifiedO recurso não mudou desde a versão especificada pelos cabeçalhos de cache do cliente.
307Temporary RedirectO recurso está temporariamente em uma URL diferente; diferente do 302, o método de requisição original deve ser reutilizado.
308Permanent RedirectO recurso foi movido permanentemente para uma nova URL; o método de requisição original deve ser reutilizado.
4xx Erro do cliente
400Bad RequestO servidor não conseguiu entender a requisição devido a uma sintaxe inválida.
401UnauthorizedA autenticação é necessária e falhou ou não foi fornecida.
402Payment RequiredReservado para uso futuro; originalmente pensado para sistemas de pagamento digital.
403ForbiddenO cliente não tem direitos de acesso ao conteúdo, mesmo que a requisição tenha sido entendida.
404Not FoundO servidor não consegue encontrar o recurso solicitado.
405Method Not AllowedO método de requisição é conhecido, mas não é suportado pelo recurso de destino.
406Not AcceptableO servidor não consegue gerar uma resposta que corresponda aos cabeçalhos Accept do cliente.
407Proxy Authentication RequiredÉ necessária autenticação com um proxy antes que a requisição possa prosseguir.
408Request TimeoutO servidor atingiu o tempo limite esperando pela requisição do cliente.
409ConflictA requisição entra em conflito com o estado atual do recurso de destino.
410GoneO recurso solicitado não está mais disponível e foi removido permanentemente.
411Length RequiredO servidor exige um cabeçalho Content-Length que estava ausente na requisição.
412Precondition FailedUma pré-condição nos cabeçalhos da requisição não foi atendida pelo servidor.
413Payload Too LargeO corpo da requisição é maior do que o servidor está disposto ou é capaz de processar.
414URI Too LongO URI solicitado é mais longo do que o servidor está disposto a interpretar.
415Unsupported Media TypeO formato de mídia da requisição não é suportado pelo servidor.
416Range Not SatisfiableO intervalo de bytes solicitado não pode ser atendido dado o tamanho do recurso.
417Expectation FailedO servidor não consegue atender à expectativa indicada no cabeçalho Expect da requisição.
418I'm a TeapotUm status bem-humorado definido como piada do Dia da Mentira na RFC 2324; servidores não deveriam fazer café.
421Misdirected RequestA requisição foi enviada a um servidor que não consegue gerar uma resposta para o URI de destino.
422Unprocessable ContentA requisição estava bem formada, mas contém erros semânticos que impedem o processamento.
423LockedO recurso que está sendo acessado está bloqueado (WebDAV).
424Failed DependencyA requisição falhou porque dependia de outra requisição que falhou (WebDAV).
425Too EarlyO servidor não está disposto a processar uma requisição que possa ser reproduzida (replay).
426Upgrade RequiredO cliente deve mudar para um protocolo diferente indicado no cabeçalho Upgrade.
428Precondition RequiredO servidor de origem exige que a requisição seja condicional.
429Too Many RequestsO cliente enviou muitas requisições em um determinado período de tempo (limitação de taxa).
431Request Header Fields Too LargeO servidor não processará a requisição porque seus campos de cabeçalho são muito grandes.
451Unavailable For Legal ReasonsO recurso está indisponível por motivos legais, como censura exigida pelo governo.
5xx Erro do servidor
500Internal Server ErrorO servidor encontrou uma condição inesperada que o impediu de atender à requisição.
501Not ImplementedO servidor não suporta a funcionalidade necessária para atender à requisição.
502Bad GatewayO servidor, atuando como gateway, recebeu uma resposta inválida de um servidor upstream.
503Service UnavailableO servidor não está pronto para lidar com a requisição, geralmente por manutenção ou sobrecarga.
504Gateway TimeoutO servidor, atuando como gateway, não recebeu uma resposta a tempo de um servidor upstream.
505HTTP Version Not SupportedA versão do HTTP usada na requisição não é suportada pelo servidor.
506Variant Also NegotiatesO servidor tem um erro de configuração interna na negociação de conteúdo.
507Insufficient StorageO servidor não consegue armazenar a representação necessária para concluir a requisição (WebDAV).
508Loop DetectedO servidor detectou um loop infinito ao processar a requisição (WebDAV).
510Not ExtendedSão necessárias extensões adicionais à requisição para que o servidor possa atendê-la.
511Network Authentication RequiredO cliente precisa se autenticar para obter acesso à rede, algo comum em portais cativos.

Exemplos de uso

Entender o que significa o código de status de uma resposta de API

Pesquise um código desconhecido, como 422, retornado por uma API de backend, para ver rapidamente o que significa e como responder a ele.

Escolher o código de redirecionamento certo

Veja a diferença entre 301 e 308, ou 302 e 307, para decidir qual status de redirecionamento usar ao mover uma URL.

Pesquisar um código visto na aba de rede do navegador

Pesquise um código de status que você viu na aba de rede das ferramentas de desenvolvedor do navegador para entender por que uma requisição falhou.

Distinguir 401 de 403 ao depurar autenticação

Pesquise '401' e '403' lado a lado para ver a distinção exata: 401 significa que a requisição não tem credenciais válidas, enquanto 403 significa que as credenciais são válidas, mas o usuário não tem permissão para acessar o recurso.

Decidir como tratar o limite de taxa em um cliente

Consulte o 429 para confirmar que ele significa excesso de requisições em um dado período e verifique se a resposta da sua API inclui um cabeçalho Retry-After que você deve respeitar antes de tentar de novo.

Perguntas frequentes

Todos os códigos desta lista são realmente padrão?

Sim — esta lista inclui apenas códigos registrados no registro oficial de códigos de status HTTP da IANA que estão em uso comum. Códigos não padronizados ou não oficiais não estão incluídos.

Por que códigos como 305 e 306 estão ausentes?

O 305 (Use Proxy) está efetivamente obsoleto por motivos de segurança, e o 306 não é usado. Como é muito improvável que você os encontre na prática, a lista foca nos códigos que você realmente vai encontrar.

Essas descrições substituem a especificação completa ou aconselhamento jurídico?

Não — são resumos curtos pensados para consulta rápida. Se o comportamento exato for importante, consulte diretamente a RFC relevante ou a especificação HTTP atual.

Qual é a diferença real entre 401 e 403?

401 Unauthorized, na verdade, significa "não autenticado" — o servidor não sabe quem você é, geralmente porque as credenciais estão ausentes ou são inválidas. 403 Forbidden significa que o servidor sabe quem você é, mas você não tem permissão para acessar aquele recurso, mesmo com credenciais válidas.

Devo usar 404 ou 410 quando um recurso deixa de existir?

Use 404 Not Found quando um recurso não existe e você não sabe (ou não quer dizer) se ele alguma vez existiu. Use 410 Gone quando você sabe com certeza que um recurso existia, mas foi removido permanentemente — isso sinaliza a clientes e mecanismos de busca que parem de solicitá-lo.

Quando devo usar 301, 302, 307 ou 308 em um redirecionamento?

301 e 308 são redirecionamentos permanentes; 302 e 307 são temporários. A diferença entre o par mais antigo (301/302) e o par mais novo (307/308) é que 307 e 308 garantem que o método e o corpo da requisição sejam preservados na requisição redirecionada, enquanto 301 e 302 historicamente permitem que os clientes mudem um POST para um GET.

Por que meu servidor retornou 500 em vez de um código mais específico?

500 Internal Server Error é um código genérico para falhas inesperadas no lado do servidor, como uma exceção não tratada. Geralmente significa que o tratamento de erros do servidor não mapeou a falha para um código 4xx ou 5xx mais específico — verifique os logs do servidor para encontrar a causa real.