Lista de códigos de status HTTP por categoria

As cinco categorias aceitas são informativa, sucesso, redirecionamento, erro do cliente e erro do servidor, correspondentes às classes 1xx a 5xx. O resultado também informa a faixa numérica e a quantidade de itens, sendo útil para documentação, testes, ferramentas de desenvolvimento e consultas rápidas ao protocolo sem enviar uma solicitação de rede nem inspecionar um servidor ativo.

Escolha uma das cinco classes de resposta HTTP

Os códigos de status HTTP são agrupados pelo primeiro dígito. As respostas informativas ocupam a faixa 100–199 e descrevem um andamento provisório antes da resposta final. Respostas de sucesso usam 200–299 e indicam que uma solicitação foi recebida, compreendida ou concluída da maneira descrita pelo código específico. Redirecionamentos usam 300–399 para seleção de recursos, mudança de localização, validação de cache e decisões de roteamento relacionadas. Erros do cliente usam 400–499 quando a solicitação não pode ser atendida por causa da sintaxe, das credenciais, das precondições, do destino, da frequência ou de outra condição do cliente. Erros do servidor usam 500–599 quando o servidor ou um intermediário não consegue concluir uma solicitação aparentemente válida. Informe uma categoria e o resultado trará o nome canônico, a faixa numérica, a contagem de itens e um array `statuses` em ordem crescente. A comparação ignora maiúsculas, espaços externos, hifens e sublinhados. Outros rótulos são rejeitados claramente, sem tentativas de adivinhação.

Interprete códigos e frases explicativas corretamente

Cada item do array contém um `code` numérico e sua `reason_phrase` padronizada. A frase é um rótulo convencional curto, não uma explicação completa de quando uma resposta deve ser gerada. Por exemplo, 404 Not Found identifica o resultado, enquanto a especificação HTTP aplicável define comportamento de cache, interações com métodos e semântica da representação. A terminologia moderna do registro é usada quando referências antigas divergem: 413 é Content Too Large e 422 é Unprocessable Content. O código 418 aparece com o rótulo de registro Unused; a conhecida frase sobre bule vem de uma especificação experimental anterior e não deve ser tratada como o título atual no registro principal. Lacunas não atribuídas são omitidas de propósito, portanto uma categoria não contém necessariamente todos os números inteiros da faixa. A lista é ordenada numericamente para que você possa montar tabelas, comparar códigos aprovados ou criar um seletor sem uma ordenação adicional. As frases são metadados descritivos: HTTP/2 e HTTP/3 não transportam esse campo, e os clientes devem decidir com base no código numérico.

Use o resultado em documentação e validação

Esta capacidade é apropriada quando uma ferramenta precisa de um conjunto de referência limitado, e não de detalhes sobre uma resposta ativa. Um gerador de documentação pode solicitar cada categoria e produzir tabelas consistentes. Um conjunto de testes pode verificar se uma aplicação emite um código registrado na classe esperada e ainda aplicar regras próprias sobre quais respostas cada endpoint permite. Um explorador de API pode preencher um menu agrupado com as frases retornadas, enquanto materiais didáticos podem comparar resultados provisórios, bem-sucedidos, de redirecionamento, de erro do cliente e de erro do servidor. O processamento é uma consulta fixa em memória: não faz solicitações de rede, não lê o estado do servidor, não armazena a entrada e sempre produz o mesmo resultado para a mesma categoria normalizada. Ele não avalia se um código é adequado a um caso de negócio específico, não acrescenta códigos de fornecedores e não interpreta o corpo da resposta. Como registros podem evoluir, quem precisa de uma referência oficial para fins jurídicos ou operacionais também deve registrar a versão da especificação usada no projeto. O navegador e a API compartilham este solucionador determinístico; uma chamada à API custa US$ 0,002.