Consultar código HTTP

Esta consulta transforma um código de 100 a 599 na frase padrão e na categoria geral: informativa, sucesso, redirecionamento, erro do cliente ou erro do servidor. Ela ajuda você a ler logs, depurar integrações, analisar alertas de monitoramento e explicar respostas de API. O resultado é determinístico, não faz chamadas de rede e identifica claramente códigos válidos que ainda não possuem uma atribuição padrão.

Entenda uma resposta sem interromper seu fluxo de trabalho

As respostas HTTP apresentam um código de três dígitos no início dos metadados do protocolo. Quando esse código aparece em uma linha de log, relatório de entrega de webhook, console do navegador, rastreamento de proxy reverso ou exceção de um cliente de API, esta consulta fornece imediatamente um rótulo legível. Informe um número inteiro entre 100 e 599. O resultado repete o código normalizado, apresenta a frase registrada ou comumente padronizada e identifica a categoria indicada pelo primeiro dígito. Por exemplo, 404 corresponde a “Not Found” e à categoria de erro do cliente, enquanto 503 corresponde a “Service Unavailable” e a erro do servidor. Esta é uma consulta de referência, não uma requisição HTTP: ela não acessa o site afetado, não testa a disponibilidade de um endpoint e não tenta deduzir a causa da resposta. Assim, a saída é estável e segura para documentação, ferramentas de suporte, scripts de terminal, enriquecimento de logs e interfaces educativas, sem aumentar a latência nem revelar uma URL privada.

Compreenda as categorias e os valores não atribuídos

As cinco categorias são definidas diretamente pelo dígito das centenas. Os códigos de 100 a 199 são informativos e descrevem uma resposta provisória. De 200 a 299 indicam sucesso. De 300 a 399 tratam de redirecionamento ou de outra etapa necessária para concluir a recuperação. De 400 a 499 descrevem um erro do cliente, quando a solicitação não pode ser atendida no formato atual. De 500 a 599 descrevem um erro do servidor ao processar uma solicitação aparentemente válida. Nem todo número desses intervalos possui uma frase atribuída. Um valor como 299 pertence estruturalmente à categoria de sucesso, mas não tem frase padrão na tabela; por isso, o resultado mostra “Não atribuído” e mantém a categoria de sucesso. Essa distinção evita confundir um intervalo válido para extensões HTTP com uma entrada malformada e impede a criação de frases enganosas. Apenas valores fora de 100 a 599, números fracionários e entradas não numéricas são rejeitados.

Use o resultado corretamente na depuração e automação

Uma frase de status é um rótulo curto, não um diagnóstico. Se uma API retorna 401 Unauthorized, a frase identifica a semântica da resposta, mas a solução real pode exigir um token, a renovação da sessão, a correção de uma assinatura ou a revisão de uma política descrita no corpo. Da mesma forma, 500 Internal Server Error indica uma falha no servidor sem revelar qual componente falhou. Use esta consulta como primeiro passo de interpretação e depois examine cabeçalhos, corpo, método da solicitação, orientação de repetição e documentação do serviço. Na automação, a categoria costuma ser mais duradoura que a frase: uma regra de monitoramento pode agrupar respostas 500–599 como erros do servidor, enquanto uma interface exibe o texto específico. Quando o comportamento exato importar, o software ainda deve decidir pelo código numérico. A API custa US$ 0,002 por solicitação e retorna pequenos campos JSON adequados para armazenamento ou exibição. Como o cálculo é local e determinístico, a mesma entrada sempre gera a mesma saída.