Como consultar códigos de estado HTTP por código ou categoria

Para que serve a consulta de códigos HTTP

Consultar um código de estado HTTP ajuda a perceber o significado associado a uma resposta, como 404, ou a percorrer uma referência organizada por categorias. Esta ferramenta usa uma coleção fixa de entradas incorporadas, com o nome, a categoria e a descrição de cada código, sem aceder à rede.

É útil quando precisa de confirmar rapidamente o significado de um código conhecido ou comparar os códigos disponíveis numa determinada categoria. A consulta serve como referência dos códigos definidos na própria ferramenta; não representa uma verificação do comportamento atual de um servidor remoto.

Como fazer a consulta

1. Introduza um código numérico no campo opcional de consulta, se já souber qual pretende verificar. O valor predefinido é 0; uma consulta com um código positivo reconhecido devolve o nome, a categoria e a descrição correspondentes.

2. Se quiser consultar a referência por grupo, deixe de selecionar um código positivo e escolha um valor no campo de categoria. A opção predefinida inclui todas as entradas. Outro valor filtra as entradas cuja designação de categoria, em minúsculas, contém o texto indicado.

3. Execute a consulta e leia o resultado apresentado. Para uma pesquisa individual, confirme se o código, o nome, a categoria e a descrição correspondem ao que procura. Para uma listagem, percorra as entradas devolvidas e use a ordenação numérica crescente para localizar um código.

4. Se o código positivo não estiver definido na referência, verifique a indicação de código desconhecido. A operação continua a ser bem-sucedida, mas não fornece uma descrição correspondente. Nesse caso, retire o código individual e use a listagem por categoria para consultar as entradas disponíveis.

Como interpretar os resultados

Um resultado individual identificado pelo código apresenta três elementos úteis: o nome atribuído ao estado, a categoria em que a entrada está incluída e a respetiva descrição. Por exemplo, uma consulta ao código 404 devolve o nome Not Found; a categoria e a descrição devem ser lidas no resultado apresentado pela ferramenta.

Numa listagem sem código positivo selecionado, a categoria escolhida determina quais as entradas incluídas. Com a opção que abrange todas as categorias, a referência não filtrada contém mais de 20 entradas, apresentadas por ordem crescente do número de estado. Um filtro textual pode selecionar uma categoria quando o seu valor aparece na designação da categoria em minúsculas.

Se surgir uma indicação de código desconhecido, isso significa que o número positivo consultado não está entre as entradas definidas na referência incorporada. O resultado não deve ser interpretado como uma confirmação sobre um serviço remoto, porque a ferramenta não faz pedidos HTTP nem consulta dados atuais através da rede.

Exemplo prático

Está a analisar uma resposta com o código 404 e quer confirmar o nome associado antes de interpretar a ocorrência.

Introduza 404 no campo de código e execute a consulta individual.

O resultado apresenta o código consultado, o nome Not Found, a categoria correspondente e uma descrição associada à entrada 404.

Limitações

• A ferramenta consulta apenas as entradas definidas na sua coleção incorporada e não faz pedidos HTTP nem confirma o estado atual de um serviço remoto.

Erros comuns

• Causa: introduzir um código positivo e esperar, ao mesmo tempo, uma listagem filtrada por categoria. Correção: para obter a listagem, não selecione um código positivo e aplique o filtro de categoria pretendido.

Perguntas frequentes

Que informação aparece ao consultar um código HTTP?

Quando introduz um código positivo reconhecido, a consulta devolve o nome, a categoria e a descrição dessa entrada. O código 404, por exemplo, corresponde ao nome Not Found.

Como filtro os códigos por categoria?

Quando não está selecionado um código positivo, o filtro de categoria aplica-se à listagem. A opção predefinida inclui todas as entradas; outro valor seleciona as entradas cuja designação de categoria em minúsculas contém esse valor.

O que acontece se o código não for reconhecido?

Um código positivo que não esteja definido na referência produz uma indicação de código desconhecido, embora a operação continue a ser bem-sucedida. A ferramenta não consulta um servidor remoto para confirmar esse código.