Referência de códigos de status HTTP
Consulte o que significa um código de status HTTP.
| 100 | Continue | A parte inicial da requisição foi recebida e o cliente deve continuar enviando o restante dela. |
| 101 | Switching Protocols | O servidor está trocando de protocolo conforme solicitado pelo cliente, por exemplo, fazendo upgrade para WebSocket. |
| 102 | Processing | O servidor aceitou a requisição completa, mas ainda não terminou de processá-la (WebDAV). |
| 103 | Early Hints | Permite que o cliente comece a pré-carregar recursos enquanto o servidor ainda prepara a resposta final. |
| 200 | OK | A requisição foi bem-sucedida e o corpo da resposta contém o recurso solicitado. |
| 201 | Created | A requisição foi bem-sucedida e, como resultado, um novo recurso foi criado. |
| 202 | Accepted | A requisição foi aceita para processamento, mas o processamento ainda não foi concluído. |
| 203 | Non-Authoritative Information | Os metadados retornados não vêm do servidor de origem, mas de uma cópia de terceiros ou do cache local. |
| 204 | No Content | A requisição foi bem-sucedida, mas não há conteúdo para retornar. |
| 205 | Reset Content | A requisição foi bem-sucedida; o cliente deve redefinir a visualização do documento que a enviou. |
| 206 | Partial Content | Apenas parte do recurso está sendo entregue, correspondendo a uma requisição de intervalo de bytes. |
| 207 | Multi-Status | Transmite informações sobre múltiplos recursos em situações em que vários códigos de status podem ser apropriados (WebDAV). |
| 208 | Already Reported | Os membros de uma vinculação WebDAV já foram listados em uma parte anterior da resposta. |
| 226 | IM Used | O servidor atendeu a uma requisição usando uma ou mais manipulações de instância. |
| 300 | Multiple Choices | A requisição tem mais de uma resposta possível; o cliente deve escolher uma delas. |
| 301 | Moved Permanently | O recurso foi movido permanentemente para uma nova URL fornecida na resposta. |
| 302 | Found | O recurso está temporariamente em uma URL diferente; requisições futuras ainda devem usar a URL original. |
| 303 | See Other | A resposta pode ser encontrada em outra URL usando uma requisição GET. |
| 304 | Not Modified | O recurso não mudou desde a versão especificada pelos cabeçalhos de cache do cliente. |
| 307 | Temporary Redirect | O recurso está temporariamente em uma URL diferente; diferente do 302, o método de requisição original deve ser reutilizado. |
| 308 | Permanent Redirect | O recurso foi movido permanentemente para uma nova URL; o método de requisição original deve ser reutilizado. |
| 400 | Bad Request | O servidor não conseguiu entender a requisição devido a uma sintaxe inválida. |
| 401 | Unauthorized | A autenticação é necessária e falhou ou não foi fornecida. |
| 402 | Payment Required | Reservado para uso futuro; originalmente pensado para sistemas de pagamento digital. |
| 403 | Forbidden | O cliente não tem direitos de acesso ao conteúdo, mesmo que a requisição tenha sido entendida. |
| 404 | Not Found | O servidor não consegue encontrar o recurso solicitado. |
| 405 | Method Not Allowed | O método de requisição é conhecido, mas não é suportado pelo recurso de destino. |
| 406 | Not Acceptable | O servidor não consegue gerar uma resposta que corresponda aos cabeçalhos Accept do cliente. |
| 407 | Proxy Authentication Required | É necessária autenticação com um proxy antes que a requisição possa prosseguir. |
| 408 | Request Timeout | O servidor atingiu o tempo limite esperando pela requisição do cliente. |
| 409 | Conflict | A requisição entra em conflito com o estado atual do recurso de destino. |
| 410 | Gone | O recurso solicitado não está mais disponível e foi removido permanentemente. |
| 411 | Length Required | O servidor exige um cabeçalho Content-Length que estava ausente na requisição. |
| 412 | Precondition Failed | Uma pré-condição nos cabeçalhos da requisição não foi atendida pelo servidor. |
| 413 | Payload Too Large | O corpo da requisição é maior do que o servidor está disposto ou é capaz de processar. |
| 414 | URI Too Long | O URI solicitado é mais longo do que o servidor está disposto a interpretar. |
| 415 | Unsupported Media Type | O formato de mídia da requisição não é suportado pelo servidor. |
| 416 | Range Not Satisfiable | O intervalo de bytes solicitado não pode ser atendido dado o tamanho do recurso. |
| 417 | Expectation Failed | O servidor não consegue atender à expectativa indicada no cabeçalho Expect da requisição. |
| 418 | I'm a Teapot | Um status bem-humorado definido como piada do Dia da Mentira na RFC 2324; servidores não deveriam fazer café. |
| 421 | Misdirected Request | A requisição foi enviada a um servidor que não consegue gerar uma resposta para o URI de destino. |
| 422 | Unprocessable Content | A requisição estava bem formada, mas contém erros semânticos que impedem o processamento. |
| 423 | Locked | O recurso que está sendo acessado está bloqueado (WebDAV). |
| 424 | Failed Dependency | A requisição falhou porque dependia de outra requisição que falhou (WebDAV). |
| 425 | Too Early | O servidor não está disposto a processar uma requisição que possa ser reproduzida (replay). |
| 426 | Upgrade Required | O cliente deve mudar para um protocolo diferente indicado no cabeçalho Upgrade. |
| 428 | Precondition Required | O servidor de origem exige que a requisição seja condicional. |
| 429 | Too Many Requests | O cliente enviou muitas requisições em um determinado período de tempo (limitação de taxa). |
| 431 | Request Header Fields Too Large | O servidor não processará a requisição porque seus campos de cabeçalho são muito grandes. |
| 451 | Unavailable For Legal Reasons | O recurso está indisponível por motivos legais, como censura exigida pelo governo. |
| 500 | Internal Server Error | O servidor encontrou uma condição inesperada que o impediu de atender à requisição. |
| 501 | Not Implemented | O servidor não suporta a funcionalidade necessária para atender à requisição. |
| 502 | Bad Gateway | O servidor, atuando como gateway, recebeu uma resposta inválida de um servidor upstream. |
| 503 | Service Unavailable | O servidor não está pronto para lidar com a requisição, geralmente por manutenção ou sobrecarga. |
| 504 | Gateway Timeout | O servidor, atuando como gateway, não recebeu uma resposta a tempo de um servidor upstream. |
| 505 | HTTP Version Not Supported | A versão do HTTP usada na requisição não é suportada pelo servidor. |
| 506 | Variant Also Negotiates | O servidor tem um erro de configuração interna na negociação de conteúdo. |
| 507 | Insufficient Storage | O servidor não consegue armazenar a representação necessária para concluir a requisição (WebDAV). |
| 508 | Loop Detected | O servidor detectou um loop infinito ao processar a requisição (WebDAV). |
| 510 | Not Extended | São necessárias extensões adicionais à requisição para que o servidor possa atendê-la. |
| 511 | Network Authentication Required | O 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.