Códigos de status HTTP

O que a página Códigos de status HTTP oferece

Códigos de status HTTP é uma referência pesquisável para os códigos de resposta de 100 a 599. Ela ajuda ao depurar chamadas de API, escrever documentação, escolher a resposta de um novo endpoint, ler logs, revisar o comportamento de um gateway ou explicar uma falha a outro desenvolvedor. Cada entrada inclui o código numérico, a frase de motivo, a categoria e uma breve descrição do que a resposta costuma significar. O filtro compara códigos, nomes, categorias e descrições, então você pode buscar valores exatos como 404, grupos amplos como redirect ou conceitos como cache, auth, proxy, timeout e validação.

A lista está incorporada diretamente na página, em vez de ser obtida de um serviço, o que a torna rápida e disponível mesmo quando você trabalha offline ou depura problemas de rede. Clicar em um resultado copia o código e a frase, facilitando colar em comentários de issues, documentos, testes ou anotações de endpoints.

Fluxo de trabalho privado no navegador

Todo o processamento acontece dentro do seu navegador, com JavaScript do lado do cliente. A ferramenta não envia trechos, valores de configuração, dados gerados, textos de consultas nem exemplos copiados para nenhum servidor e não exige conta. Esse modelo exclusivamente local é importante em utilitários para desenvolvedores, porque o conteúdo colado neles costuma parecer dados reais de aplicações: respostas de API, logs, amostras no formato de variáveis de ambiente, consultas de banco de dados, marcação de rascunhos ou valores copiados de sessões de depuração em produção. Manter a transformação local reduz riscos e deixa a interação rápida, pois não há ida e volta pela rede.

A interface é propositalmente compacta para que você cole a entrada, ajuste as opções, inspecione a saída, copie e volte ao seu editor. Ainda assim, revise os resultados antes de fazer commit, compartilhá-los publicamente ou usá-los em um fluxo de produção. Ferramentas de navegador são excelentes para inspeção e preparação rápidas, mas não conseguem conhecer todas as convenções de um projeto, regras de classificação de dados ou requisitos de validação específicos de uma aplicação.

Dicas práticas

Os códigos de status fazem parte do contrato de uma API, então escolha-os com critério. Use respostas da família 400 quando o cliente puder alterar a requisição, da família 500 quando o servidor não conseguiu atender a uma requisição válida e da família 300 quando o cliente deve procurar em outro lugar. Falhas de autenticação e de autorização costumam ser confundidas: 401 geralmente significa que a autenticação é necessária ou inválida, enquanto 403 significa que o chamador autenticado não tem permissão. Ao documentar APIs, combine o código com um esquema do corpo da resposta e orientações de correção.