Sobre esta ferramenta
Os códigos de status HTTP são a resposta de três dígitos de toda requisição na web: 2xx quer dizer que deu certo, 3xx que o cliente deve ir para outro lugar, 4xx que a requisição tem um problema e 5xx que o servidor falhou. Esta referência lista os códigos da RFC 9110 e as extensões comuns (429 Too Many Requests, 103 Early Hints, 451…), cada um com a frase oficial, uma explicação simples, quando uma API ou site deve devolvê-lo e um link para a especificação. Busque por número (4 mostra todos os 4xx) ou por palavra (timeout, redirect, cache), ou filtre por classe ou pelos mais usados. Responde às dúvidas clássicas: 401 ou 403, 301 ou 308, 400 ou 422, 502 ou 504.
Como usar
- 1 Digite um código ou uma palavra, como 404, 50 ou timeout.
- 2 Ou filtre por classe (1xx a 5xx) ou pelos códigos mais usados.
- 3 Leia o que o código significa e quando usar.
- 4 Abra o link da RFC para a definição exata.
Perguntas frequentes
Qual a diferença entre 401 e 403?
401 Unauthorized quer dizer que a requisição não tem credenciais válidas: o cliente deve fazer login ou renovar o token. 403 Forbidden quer dizer que o servidor sabe quem você é e mesmo assim recusa: fazer login de novo não resolve.
Devo usar 301 ou 308 num redirecionamento permanente?
Para páginas, 301 é o mais comum e todo navegador e buscador entende. O 308 quer dizer o mesmo, mas garante que o método e o corpo se repetem — use em endpoints de API que recebem POST ou PUT.
Quando uma API deve devolver 400 e quando 422?
Use 400 quando não dá para ler a requisição — JSON quebrado, parâmetro faltando ou tipo errado. Use 422 quando ela está bem formada, mas os dados não passam nas suas regras, como um e-mail inválido ou uma data no passado.
Incorporar esta ferramenta
Adicione esta ferramenta grátis ao seu site — copie o código abaixo. Ele fica sempre atualizado.
Ferramentas para o seu site →