Consulta de códigos de status HTTP

O que é Consulta de códigos de status HTTP?

Quando Usar Esta Calculadora

• Depurar uma integração de API em que uma solicitação está falhando e você precisa entender o que o código de status realmente significa
• Decidir qual código de status HTTP retornar da sua própria API para uma condição de erro específica
• Ensinar ou aprender os fundamentos de HTTP em um curso ou bootcamp de desenvolvimento web
• Escrever middleware de tratamento de erros que precisa distinguir entre diferentes casos de 4xx e 5xx
• Investigar por que um redirecionamento não está funcionando verificando se 301 ou 302 foi retornado
• Solucionar problemas de CORS em que o navegador mostra um erro de rede, mas o servidor retornou 200

Passos:

1. Digite um código de status (como 404) ou uma palavra-chave (como "forbidden") na caixa de pesquisa.
2. Filtre por categoria usando os botões 1xx-5xx se quiser navegar por uma faixa específica.
3. Leia a descrição em linguagem simples do que o código significa e quando ele é normalmente retornado.
4. Use isso como uma referência rápida ao depurar respostas de API ou ao criar tratamento de erros.

Fórmula

Casos de uso

• Entender rapidamente um código de status desconhecido retornado por uma API com a qual você está integrando
• Decidir qual código de status retornar da sua própria API para uma determinada condição de erro
• Depurar por que uma solicitação está falhando verificando o que um código específico realmente implica
• Ensinar ou aprender os fundamentos de HTTP em um curso de desenvolvimento web
• Escrever lógica precisa de tratamento de erros que distingue entre diferentes casos de 4xx e 5xx

Benefícios Principais

• Todos os códigos de status comuns em uma única referência pesquisável
• Explicações em linguagem simples, não apenas terminologia formal da RFC
• Filtre instantaneamente por categoria (de 1xx a 5xx)
• Grátis, rápido e sem necessidade de cadastro

Dicas Profissionais

• Reserve códigos 5xx estritamente para falhas do lado do servidor — nunca os use para sinalizar erros de entrada do cliente
• Use 429 com um cabeçalho Retry-After ao aplicar limite de taxa, para que clientes bem comportados saibam quando tentar novamente
• Prefira 404 em vez de uma página de erro genérica sempre que um recurso genuinamente não existir — é melhor para usuários e mecanismos de busca
• Ao projetar uma API, escolha códigos 4xx específicos (422, 409, 400) em vez de usar por padrão um 400 genérico para tudo

Erros Comuns a Evitar

• Retornar 200 OK para uma solicitação que na verdade falhou, escondendo erros das ferramentas de monitoramento
• Confundir 401 (não autenticado) com 403 (autenticado, mas sem autorização)
• Usar 302 para um redirecionamento que deveria ser permanente (301), prejudicando o SEO
• Tratar todos os erros 4xx e 5xx da mesma forma no tratamento de erros do lado do cliente, em vez de ramificar pelo código específico

Termos Chave Explicados

• Linha de status: A primeira linha de uma resposta HTTP, contendo o código de status e uma curta frase de motivo
• Idempotente: Uma propriedade de certos métodos HTTP em que repetir a mesma solicitação tem o mesmo efeito que fazê-la uma vez
• Cadeia de redirecionamento: Uma sequência de vários redirecionamentos que um navegador segue antes de chegar ao recurso final
• Limite de taxa: Restringir quantas solicitações um cliente pode fazer em uma determinada janela de tempo, muitas vezes sinalizado com 429

Conceitos relacionados

• [object Object]
• [object Object]
• [object Object]
• [object Object]
• [object Object]

Exemplo

Interpretação dos seus resultados