Códigos de status HTTP — oficiais e não oficiais (nginx, Cloudflare)

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, a RFC que o define e uma breve descrição do que a resposta costuma significar. Chips de filtro reduzem a lista a códigos informativos, de sucesso, de redirecionamento, de erro do cliente ou de erro do servidor.

O tráfego real também contém códigos que nenhum padrão define. Um 499 em um log do nginx significa que o cliente desistiu antes de o servidor responder; um 522 da Cloudflare significa que a origem não concluiu o handshake TCP; um 460 ou 561 vem de um balanceador de carga da AWS. Esses códigos não oficiais ficam em seu próprio grupo, junto com o produto que os emite, para que você identifique rapidamente se a falha veio da sua aplicação, de um proxy ou de uma CDN. Clicar em um resultado copia o código e a frase para 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 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, e nada do que você digita é enviado a lugar nenhum.

Dicas práticas

Códigos de status fazem parte do contrato de uma API, então escolha-os com critério. Use respostas da faixa 400 quando o cliente puder alterar a requisição, respostas da faixa 500 quando o servidor falhar ao atender uma requisição válida e respostas da faixa 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. Prefira 422 para erros de validação em um corpo bem formado, 409 para conflitos de estado e 429 com um cabeçalho Retry-After para limitação de taxa. Nunca retorne códigos não oficiais na sua própria API — clientes e bibliotecas podem não entendê-los.