Códigos de estado HTTP

O que é uma referência de códigos de estado HTTP?#

Toda resposta HTTP carrega um código de estado de três dígitos que diz ao cliente, num único número, o que aconteceu com o seu pedido. Os dígitos não são aleatórios: o primeiro dígito nomeia uma família — 1xx significa “espere, estou enviando informação”, 2xx significa “aqui está, funcionou”, 3xx significa “vá procurar em outro lugar”, 4xx significa “você, o cliente, errou”, e 5xx significa “eu, o servidor, errei”. Decore essas cinco famílias e você consegue ler qualquer troca HTTP num relance, seja um pedido do navegador, um curl que você executou, ou um erro nos registros da sua aplicação.

O problema é que existem mais de sessenta códigos em uso ativo, e as diferenças entre vizinhos costumam ser sutis: 401 versus 403, 302 versus 307, 422 versus 400. Esta página é uma referência pesquisável de todos eles — o código, a sua frase de razão IANA, a sua família e uma explicação simples. Digite um número ou uma palavra e a tabela se estreita instantaneamente.

Como usar#

1. Navegue ou pesquise. A tabela lista todos os códigos agrupados por família (1xx a 5xx). Use a caixa de Pesquisa no topo para filtrar.
2. Pesquise do jeito que você pensa. O filtro é inteligente quanto à intenção:
   • Digite um número como 30 ou 418 e ele corresponde aos códigos por prefixo — 30 revela toda a família de redirecionamento 3xx.
   • Digite uma palavra como redirect, timeout ou teapot e ele busca na frase de razão e na descrição, sem distinguir maiúsculas de minúsculas.
3. Leia a linha. Cada linha mostra Código (o número), Razão (a frase padrão como “Not Found”), Categoria (o rótulo localizado da família) e Descrição (uma curta explicação de quando esse código é retornado). A barra de estado sob a tabela relata quantas linhas corresponderam.

Principais funcionalidades#

• O conjunto IANA completo, mais códigos de fato. Cobre todos os códigos que a web de fato retorna, de 100 Continue a 511 Network Authentication Required, incluindo as entradas 207/208/226 específicas de WebDAV, a piada 418 I'm a Teapot e o 451 imposto por lei.
• Pesquisa numérica ciente de prefixo. Digitar 4 não despeja um subconjunto aleatório — dá a você todos os erros de cliente 4xx em ordem, o que é exatamente como você explora uma família que não recorda.
• Busca por palavra na razão e na descrição. “rate” encontra 429 Too Many Requests; “range” encontra 416 Range Not Satisfiable; “auth” revela tanto 401 quanto 407.
• Frases de razão são universais. As frases (“Not Found”, “Gateway Timeout”) são identificadores técnicos, não traduções — elas correspondem ao que os servidores de fato enviam na transmissão, então você pode colá-las diretamente em documentação ou num issue tracker.
• Roda inteiramente no seu navegador. O conjunto de dados acompanha a página; a filtragem acontece localmente, sem requisição de rede.

Exemplo prático#

Três códigos que enganam quase todo desenvolvedor pelo menos uma vez são o trio de erro de cliente 401, 403 e 404. Pesquise pelos dígitos 40 e você tem todos eles numa única vista, lado a lado:

• 401 Unauthorized — “Authentication is required and has failed or has not been provided.” O servidor não sabe quem você é. Correção: envie credenciais (um token de login, uma chave de API).
• 403 Forbidden — “The request was valid but the server is refusing action (insufficient rights).” O servidor sabe exatamente quem você é, e ainda assim não pode ter isto. Correção: obtenha permissão, não outra senha.
• 404 Not Found — “The requested resource could not be found.” A própria URL está errada ou o recurso sumiu. Correção: corrija o caminho.

A distinção mais útil é 401 versus 403: “não o conheço” (faça login) versus “conheço-o, e não” (peça acesso). Reautenticar nunca vai corrigir um 403, e mexer na URL nunca vai corrigir um 401.

Uma segunda busca útil é a família de redirecionamento. Pesquise 30 e você vê que 301 e 302 historicamente permitiam aos clientes mudar o método no pedido seguinte (um POST podia degradar para GET), enquanto 307 e 308 foram introduzidos precisamente para preservar o método original — o motivo pelo quais APIs modernas que redirecionam envios de formulário o apontam para 307/308 em vez de 301/302.

FAQ#

O que o primeiro dígito de um código de estado significa?#

Ele nomeia a família. 1xx é informativo (o servidor está dizendo “espere, mais por vir”), 2xx é sucesso, 3xx é redirecionamento (procure em outro lugar), 4xx é erro de cliente (o seu pedido estava errado) e 5xx é erro de servidor (o pedido estava bom, mas o servidor falhou). Os dois dígitos restantes identificam o código específico dentro daquela família.

418 é um código de estado real?#

Originou-se como uma RFC de 1º de abril sobre uma chaleira que se recusa a preparar café, então não se destina à produção. Dito isso, alguns serviços genuinamente retornam 418 como uma resposta bem-humorada de “você me enviou algo sem sentido”, e é inofensivo reconhecê-lo. Esta referência o lista porque você o encontrará no mundo real.

Por que alguns códigos estão marcados como WebDAV?#

Códigos como 207 Multi-Status, 423 Locked e 507 Insufficient Storage foram definidos para WebDAV, uma extensão do HTTP para edição colaborativa de arquivos. São raros em APIs web comuns, mas aparecem em sistemas que expõem uma interface semelhante a um sistema de arquivos, então as descrições registram a origem WebDAV para que o contexto faça sentido.

De onde vêm as frases de razão?#

Elas são as frases de razão padrão em inglês registradas na IANA — as mesmas strings que os servidores anexam após o código na linha de estado (por exemplo, HTTP/1.1 404 Not Found). São identificadores técnicos, então são mostradas de forma literal em vez de traduzidas; a parte localizada da página são os cabeçalhos das colunas, os rótulos de categoria e este texto explicativo.