Referência de códigos de status HTTP

• Referência completa de códigos de status HTTP: Navegue por todos os códigos de status HTTP de 100 a 511 com descrições, casos de uso, exemplos e referências RFC. Nossa referência cobre todos os códigos padrão das cinco categorias.
• Pesquisa e filtragem instantâneas: Pesquise por número do código, nome ou descrição para encontrar qualquer código de status HTTP na hora. Filtre por categoria (1xx, 2xx, 3xx, 4xx, 5xx) para focar nos códigos relevantes para o seu trabalho.
• Referência de códigos de status HTTP online — sem instalação: Use nossa referência direto em qualquer navegador, sem downloads, plugins ou instalações. Consulte qualquer código de status de qualquer dispositivo e em qualquer lugar, instantaneamente.
• 100% grátis para sempre: Nossa referência é totalmente gratuita, sem cadastro, sem anúncios e sem limites de uso. Consulte códigos de status HTTP quantas vezes precisar — grátis para sempre.

• Desenvolvimento e depuração de API: Consulte o código de status HTTP correto a retornar pelos seus endpoints de API. Nossa referência ajuda desenvolvedores a escolher entre 200, 201, 204, 400, 401, 403, 404, 409, 422 e outros códigos em cada cenário.
• Tratamento de erros e solução de problemas: Identifique rapidamente o que um código de status HTTP significa ao depurar respostas de API, logs de servidor ou erros de rede. Nossa referência explica cada código com exemplos práticos.
• Design de API REST: Projete APIs REST semanticamente corretas usando os códigos de status certos para cada operação. Nossa referência cobre toda a gama de códigos para operações CRUD, autenticação, limitação de requisições e redirecionamentos.
• Desenvolvimento frontend: Trate respostas HTTP corretamente em aplicações frontend entendendo o que cada código significa. Use nossa referência para implementar tratamento de erros adequado em respostas 401, 403, 404, 429 e 500.
• DevOps e infraestrutura: Interprete códigos de status HTTP em logs de servidor, métricas de balanceadores de carga e painéis de monitoramento. Nossa referência ajuda engenheiros DevOps a entender 502, 503, 504 e outros erros de gateway.
• Aprendizado e educação: Aprenda códigos de status HTTP para cursos de desenvolvimento web, certificações e entrevistas. Nossa referência oferece descrições claras, casos de uso e exemplos de cada código.

Códigos de status HTTP são números de três dígitos retornados por um servidor em resposta à requisição de um cliente. Eles são definidos na RFC 9110 (HTTP Semantics) e organizados em cinco classes conforme o primeiro dígito. Códigos 1xx são informativos — a requisição foi recebida e o processamento continua. Códigos 2xx indicam sucesso — a requisição foi recebida, compreendida e aceita. Códigos 3xx indicam redirecionamento — é necessária uma ação adicional para completar a requisição. Códigos 4xx indicam erros do cliente — a requisição contém sintaxe incorreta ou não pode ser atendida. Códigos 5xx indicam erros do servidor — o servidor não conseguiu atender uma requisição válida. Nossa referência cobre todos os códigos padrão das cinco categorias.

1. 1. Pesquise por código ou nome: Digite um número de código (por exemplo «404»), um nome (por exemplo «Not Found») ou uma palavra-chave (por exemplo «rate limit») na caixa de pesquisa para filtrar a lista na hora. Toda a filtragem roda localmente no seu navegador.
2. 2. Filtre por categoria: Use a lista suspensa de categorias para focar em uma classe específica de códigos de status — 1xx Informativo, 2xx Sucesso, 3xx Redirecionamento, 4xx Erros do cliente ou 5xx Erros do servidor.
3. 3. Expanda para ver os detalhes: Clique em qualquer linha de código de status para expandi-la e ver a descrição completa, o caso de uso prático, um exemplo concreto e a referência RFC.

• 1xx - Informativo: Respostas provisórias indicando que a requisição foi recebida e o processamento continua. Raramente vistos na prática, exceto 101 (upgrade para WebSocket) e 103 (Early Hints para pré-carregamento de recursos).
• 2xx - Sucesso: A categoria mais comum. 200 OK é a resposta de sucesso padrão. 201 Created é usado após criar um recurso. 204 No Content é usado em operações bem-sucedidas sem corpo de resposta. 206 Partial Content é usado em requisições por faixa e streaming de vídeo.
• 3xx - Redirecionamento: Indica que o cliente deve executar uma ação adicional. 301 e 308 são redirecionamentos permanentes (301 pode alterar o método, 308 o preserva). 302 e 307 são redirecionamentos temporários. 304 Not Modified habilita o cache do navegador.
• 4xx - Erros do cliente: A requisição contém um erro. 400 Bad Request para entradas malformadas. 401 Unauthorized para autenticação ausente. 403 Forbidden para permissões insuficientes. 404 Not Found para recursos inexistentes. 429 Too Many Requests para limitação de requisições.
• 5xx - Erros do servidor: O servidor não conseguiu processar uma requisição válida. 500 Internal Server Error para exceções não tratadas. 502 Bad Gateway para falhas do upstream. 503 Service Unavailable para manutenção ou sobrecarga. 504 Gateway Timeout para tempos limite do upstream.

Retornar o código de status HTTP correto é essencial para APIs e sites bem projetados. Use 200 em requisições GET bem-sucedidas que retornam dados. Use 201 após criar um recurso com POST. Use 204 para DELETE ou PUT bem-sucedidos sem corpo de resposta. Use 400 para erros de validação, 401 para autenticação ausente, 403 para falhas de autorização e 404 para recursos inexistentes. Use 422 para erros de validação semântica (dados bem formados, mas inválidos). Use 429 para limitação de requisições. Use 500 apenas para erros inesperados do servidor — nunca para erros do cliente. Códigos de status corretos melhoram a usabilidade da API, permitem tratamento de erros adequado nos clientes e ajudam os mecanismos de busca a entender a estrutura do seu site.