Referência de Códigos de Status HTTP
Os códigos de status HTTP são os números de três dígitos que um servidor web retorna para informar ao cliente se uma requisição foi bem-sucedida, redirecionada ou falhou. Esta referência permite consultar e buscar todos os códigos padrão, de 1xx a 5xx, com uma descrição em linguagem simples, casos de uso reais, cabeçalhos comuns e códigos relacionados para cada um.
Foi feita para desenvolvedores web, desenvolvedores de API, analistas de QA e administradores de sistemas que precisam consultar um código rapidamente, entender exatamente quando retorná-lo e comparar códigos fáceis de confundir — como 401 versus 403 ou 301 versus 302.
Como Usar Esta Referência
Busque um código
Digite na caixa de busca para filtrar na hora. Busque pelo número do código (404), pelo nome (redirecionamento) ou por uma palavra-chave da descrição (proxy) para encontrar todos os códigos correspondentes.
Filtre por categoria
Clique nas abas — Todos, 1xx, 2xx, 3xx, 4xx ou 5xx — para exibir apenas um grupo quando você sabe o tipo de resposta, mas não o código exato.
Abra os detalhes
Clique em qualquer cartão de código de status para expandi-lo e revelar seus casos de uso, cabeçalhos de resposta comuns e códigos relacionados. Clique em um código relacionado para ir direto a ele.
Fixe seus favoritos
Toque no ícone de marcador em qualquer código para fixá-lo no topo da página. Os marcadores ficam salvos no seu navegador, então permanecem entre as sessões. Use Copiar para pegar o código e o nome em um clique.
Recursos
Lista Completa de Códigos de Status
Consulte todos os códigos de status HTTP padrão, organizados nas cinco categorias de 1xx a 5xx — incluindo os pouco vistos, como 103, 418 e 451.
Categorias com Cores
Cada grupo tem sua própria cor — Informativo, Sucesso, Redirecionamento, Erro do Cliente e Erro do Servidor — para você identificar o tipo de resposta num relance.
Busca Instantânea
Filtre enquanto digita por número do código, nome do status ou qualquer palavra-chave da descrição para achar o código certo em segundos.
Abas de Filtro por Categoria
Alterne entre as abas Todos, 1xx, 2xx, 3xx, 4xx e 5xx para restringir a lista a uma única categoria de resposta.
Casos de Uso Práticos
Expanda qualquer código para ver cenários reais que explicam quando e por que um servidor o retorna, ajudando você a escolher o código certo para a sua API.
Cabeçalhos de Resposta Comuns
Cada código lista os cabeçalhos de resposta normalmente enviados com ele, como Location, Retry-After ou WWW-Authenticate.
Navegação por Códigos Relacionados
Códigos comumente confundidos ficam ligados entre si — vá de 401 para 403 ou de 301 para 302 para comparar as diferenças na hora.
Fixe para Acesso Rápido
Marque os códigos que você mais usa para que fiquem sempre no topo da página. Os marcadores são salvos localmente — sem precisar de conta.
Copiar para a Área de Transferência
Copie um código de status e seu nome juntos em um clique, prontos para colar no seu código, na documentação ou em um relatório de bug.
Perguntas Frequentes
O que significa o código de status HTTP 200?
O 200 OK é a resposta padrão de sucesso. Significa que a requisição foi recebida, compreendida e concluída, e que o corpo da resposta contém o recurso solicitado. Você o verá em um GET bem-sucedido, em um POST que retorna dados ou em qualquer chamada de API que devolve o recurso pedido.
Qual a diferença entre erros 4xx e 5xx?
Os códigos 4xx são erros do cliente — a própria requisição tem um problema, como uma URL incorreta (404), autenticação ausente (401) ou dados malformados (400), de modo que repetir a mesma requisição sem mudanças falhará de novo. Os códigos 5xx são erros do servidor — a requisição era válida, mas o servidor não conseguiu atendê-la, como em 500 Internal Server Error ou 503 Service Unavailable. Com 5xx, a correção costuma estar no lado do servidor.
O que significam os códigos de status 404, 500 ou 403?
404 Not Found significa que o servidor não consegue encontrar o recurso solicitado — a URL não é reconhecida. 500 Internal Server Error é uma mensagem genérica para uma condição inesperada no servidor, como uma exceção não tratada. 403 Forbidden significa que o servidor entendeu a requisição, mas se recusa a autorizá-la; ao contrário do 401, autenticar-se de novo não ajuda, porque o problema é de permissão, não de identidade.
Qual a diferença entre 401 e 403?
401 Unauthorized significa que nenhuma credencial de autenticação válida foi fornecida — o cliente deve fazer login e tentar de novo. 403 Forbidden significa que o cliente está autenticado, mas não tem permissão para acessar o recurso, então autenticar-se novamente não muda o resultado.
Quando devo usar um redirecionamento 301 ou 302?
Use 301 Moved Permanently quando um recurso for movido permanentemente para uma nova URL, como uma mudança de domínio ou reestruturação de URLs — os mecanismos de busca atualizarão o índice para o novo endereço. Use 302 Found para um redirecionamento temporário, em que a URL original ainda deve ser usada no futuro, como uma página de manutenção ou um teste A/B.
O que significa 502 Bad Gateway?
502 Bad Gateway significa que um servidor atuando como gateway ou proxy recebeu uma resposta inválida do servidor upstream. Costuma acontecer quando um proxy reverso como o Nginx não consegue alcançar a aplicação de backend ou quando o backend retorna uma resposta malformada.
Meus códigos fixados ficam salvos?
Sim. Os códigos fixados são armazenados no armazenamento local do seu navegador e persistem entre atualizações de página e sessões do navegador. Nenhuma conta ou conexão com servidor é necessária — e, como os dados são locais, seus marcadores permanecem privados no seu dispositivo.
Ainda não há comentários. Seja o primeiro a comentar!