Referência de códigos de status HTTP

Como funciona

Toda resposta HTTP começa com um código de três dígitos, e só o primeiro já diz em qual das cinco classes você está. Esta referência cobre os 46 códigos que um desenvolvedor realmente encontra, cada um com um resumo de uma linha e uma nota expandida com a causa comum e a primeira ação a tentar — filtre por classe, busque por código ou frase e clique em qualquer linha para abrir.

As cinco classes

1xx é informativo — sinais intermediários que normalmente se completam no manejo de conexão do cliente. 2xx é sucesso, com subtipos para criado (201), aceito-mas-inacabado (202) e deliberadamente vazio (204). 3xx é redirecionamento: vá para outra URL sob regras declaradas. 4xx é erro do cliente — o pedido enviado não era aceitável. 5xx é erro do servidor — o pedido estava bom, o servidor não entregou. A divisão mais útil ao depurar: 4xx olhe o que você enviou, 5xx olhe o que eles rodam.

Idempotência e novas tentativas

Seguros para repetir com backoff: 408, 425, 429 (respeite Retry-After) e a família 5xx — 500, 502, 503, 504. Nunca valem retry às cegas os 4xx sobre o próprio payload (400, 413, 415) nem falhas de autorização (401, 403). Códigos como 409 e 412 só aceitam nova tentativa depois de você reler o estado atual e resolver o conflito — repetir o mesmo pedido só falha de novo.

Redirecionamentos permanentes vs temporários

301 e 308 ficam em cache praticamente para sempre: use só quando a URL antiga nunca voltará, e saiba que um erro continua perseguindo usuários depois de corrigido o servidor. 302, 303 e 307 não são armazenados — o navegador pergunta de novo pela URL original — e diferem no modo de reescrever o método: 303 força GET, 307 preserva o método, 302 o conserva na prática mas sem garantia.

Perguntas frequentes