O que são Códigos de Status HTTP?

Códigos de status HTTP são números de três dígitos retornados por um servidor web em resposta à requisição de um cliente. Eles indicam se a requisição foi bem-sucedida, redirecionada ou resultou em um erro. Compreender esses códigos é essencial para desenvolvimento web, design de APIs e depuração.

Categorias de Códigos de Status

Os códigos de status HTTP são agrupados em cinco categorias com base no primeiro dígito:

1xx (Informativo)

A requisição foi recebida e o servidor está continuando a processá-la

2xx (Sucesso)

A requisição foi recebida, compreendida e aceita com sucesso

3xx (Redirecionamento)

Ações adicionais são necessárias para completar a requisição (geralmente um redirecionamento)

4xx (Erro do Cliente)

A requisição contém um erro no lado do cliente

5xx (Erro do Servidor)

O servidor falhou ao atender uma requisição válida

Quem Usa Esta Ferramenta?

Esta ferramenta de referência foi projetada para desenvolvedores web, desenvolvedores de APIs, testadores de QA e administradores de sistemas que precisam consultar rapidamente códigos de status HTTP, entender quando usar cada um e comparar códigos similares.

Como Usar Esta Ferramenta

Navegue por Categoria

Todos os códigos de status HTTP são exibidos em grupos por sua categoria (1xx a 5xx). Cada grupo tem uma cor distinta para fácil identificação. Simplesmente role pela lista para navegar por todos os códigos.

Pesquise um Código

Use a barra de pesquisa no topo para encontrar um código de status específico. Você pode pesquisar por:

Número do código — Digite "404" para encontrar 404 Not Found
Nome ou palavra-chave — Digite "redirecionamento" para encontrar todos os códigos relacionados a redirecionamento
Palavra-chave da descrição — Digite "proxy" para encontrar códigos que mencionam servidores proxy

Filtre por Categoria

Clique nas abas de categoria (Todos, 1xx, 2xx, 3xx, 4xx, 5xx) para mostrar apenas códigos de um grupo específico. Isso é útil quando você conhece o tipo geral de resposta, mas não o código exato.

Visualize Detalhes

Clique em qualquer cartão de código de status para expandi-lo e ver informações detalhadas, incluindo:

Casos de Uso — Cenários do mundo real quando este código é retornado
Headers Comuns — Headers de resposta tipicamente associados a este código
Códigos Relacionados — Códigos similares ou frequentemente confundidos para comparação

Salve Seus Favoritos

Clique no ícone de marcador em qualquer código para salvá-lo. Os códigos salvos aparecem no topo da página para acesso rápido. Seus marcadores são salvos no seu navegador e persistem entre sessões.

Recursos

Referência Completa de Códigos de Status HTTP

Esta ferramenta cobre todos os códigos de status HTTP padrão definidos em RFCs, incluindo códigos comumente usados e menos comuns.

200 OK, 301 Moved Permanently, 404 Not Found
500 Internal Server Error
103 Early Hints, 418 I'm a Teapot
451 Unavailable For Legal Reasons

Categorias com Código de Cores

Cada categoria é visualmente distinguida com seu próprio esquema de cores, facilitando a identificação do tipo de resposta à primeira vista.

Códigos informativos são azuis
Códigos de sucesso são verdes
Códigos de redirecionamento são âmbar
Códigos de erro do cliente são vermelhos
Códigos de erro do servidor são roxos

Casos de Uso Práticos

Cada código de status inclui casos de uso do mundo real que explicam quando e por que um servidor retorna esse código específico.

Escolha o código de status correto para design de API
Entenda respostas de erro ao depurar
Aprenda as melhores práticas para respostas HTTP

Comparação de Códigos Relacionados

Códigos frequentemente confundidos são vinculados juntos, permitindo que você navegue rapidamente entre eles e entenda as diferenças.

Compare 401 vs 403
Entenda redirecionamentos 301 vs 302
Diferencie erros 400 vs 422

Salve e Acesso Rápido

Marque seus códigos de status mais usados para que sempre apareçam no topo.

Marcadores salvos localmente no seu navegador
Nenhuma conta necessária
Persistem entre sessões

Dica Pro: Use as categorias com código de cores e o recurso de marcadores juntos para criar seu guia de referência rápida personalizado para os códigos de status que você usa com mais frequência em seus projetos.

Perguntas Frequentes

Qual é a diferença entre 401 e 403?

401 Unauthorized

Autenticação Necessária

O cliente não forneceu credenciais de autenticação válidas. O cliente deve se autenticar (fazer login) e tentar novamente.

Usuário precisa fazer login
Credenciais ausentes ou inválidas
Autenticar novamente resolverá o problema

403 Forbidden

Permissão Negada

O cliente está autenticado, mas não tem permissão para acessar o recurso. Autenticar novamente não ajudará.

Usuário está logado, mas não tem permissão
O acesso é restrito por função ou política
Autenticação não resolverá o problema

Quando devo usar redirecionamento 301 vs 302?

301 Moved Permanently

Redirecionamento Permanente

Use quando um recurso foi permanentemente movido para uma nova URL. Os mecanismos de busca atualizarão seu índice.

Mudança de domínio ou migração
Reestruturação de URL
Realocação permanente de conteúdo
Valor de SEO é transferido para a nova URL

302 Found

Redirecionamento Temporário

Use para redirecionamentos temporários onde a URL original ainda deve ser usada no futuro.

Redirecionamento de página de manutenção
Cenários de teste A/B
Realocação temporária de conteúdo
Valor de SEO permanece com a URL original

Qual é a diferença entre 400 e 422?

400 Bad Request

Requisição Malformada

A requisição está malformada — o servidor não consegue analisá-la.

Sintaxe JSON inválida
Estrutura XML malformada
Headers obrigatórios ausentes
Erros no nível de sintaxe

422 Unprocessable Content

Erro Semântico

A requisição está sintaticamente correta, mas semanticamente inválida.

JSON válido, mas valores de campo inválidos
Falhas na validação da lógica de negócios
Incompatibilidades de tipo de dados
Erros no nível semântico

O que significa 502 Bad Gateway?

Um erro 502 Bad Gateway significa que um servidor atuando como gateway ou proxy recebeu uma resposta inválida do servidor upstream.

Causas Comuns

Proxy reverso (como Nginx) não consegue alcançar a aplicação backend
Servidor backend está inativo ou sobrecarregado
Backend retorna uma resposta malformada
Problemas de conectividade de rede entre proxy e backend
Timeout aguardando resposta do servidor upstream

Dica de Solução de Problemas: Verifique os logs da sua aplicação backend e certifique-se de que o servidor upstream está em execução e acessível a partir do servidor proxy.

Meus códigos salvos são mantidos?

Sim. Os códigos salvos são armazenados no armazenamento local do seu navegador e persistirão entre atualizações de página e sessões do navegador.

Nenhuma conta ou conexão com servidor necessária
Dados armazenados localmente no seu navegador
Persistem entre sessões e atualizações de página
Privado apenas para seu navegador

Nota: Se você limpar o armazenamento local do seu navegador ou usar um navegador/dispositivo diferente, seus códigos salvos não estarão disponíveis. Os marcadores são específicos do dispositivo e do navegador.