Códigos de estado HTTP
Procure um código HTTP: significado e quando usá-lo.
- Instantânea
- Grátis
- Privada (processada localmente)
- Sem registo
O dicionário de códigos HTTP, a uma pesquisa de distância
Quando um pedido web falha, o servidor devolve um código de três algarismos. Esta ferramenta reúne-os e explica-os: escreva um número (404) ou uma frase («not found»), filtre por classe e leia o significado e o uso correto de cada código.
-
Pesquise
Por número, por frase ou por classe («4» para os 4xx).
-
Leia a ficha
Código, frase oficial, categoria e descrição.
-
Escolha o código certo
Para a sua API, redireção ou página de erro.
As quatro grandes famílias
| Classe | Sentido | Exemplos |
|---|---|---|
| 2xx | Sucesso | 200 OK, 201 Created, 204 No Content |
| 3xx | Redireção | 301 Moved, 302 Found, 304 Not Modified |
| 4xx | Erro de cliente | 400, 401, 403, 404, 429 |
| 5xx | Erro de servidor | 500, 502, 503, 504 |
Reflexo de depuração: o primeiro algarismo indica o lado. Um 4xx corrige-se no pedido (URL, permissões, formato); um 5xx no servidor (código, configuração, sobrecarga).
Perguntas frequentes
O que significam as classes 2xx, 3xx, 4xx, 5xx?
O primeiro algarismo dá a categoria: 2xx = sucesso, 3xx = redireção, 4xx = erro do cliente (o seu pedido), 5xx = erro do servidor. Um olhar ao primeiro algarismo já diz de quem é o problema.
Qual a diferença entre 401 e 403?
401 (Unauthorized) significa «identifica-te»: a autenticação falta ou falhou. 403 (Forbidden) significa «sei quem és, mas não tens permissão». O primeiro resolve-se ao iniciar sessão, o segundo não.
Quando usar 301 em vez de 302?
301 (Moved Permanently) para uma mudança definitiva: os motores de busca transferem o ranking para o novo URL. 302 (Found) para uma mudança temporária: o URL antigo continua a referência. Errar prejudica o SEO.
O código 418 existe mesmo?
Sim! 418 «I’m a teapot» vem de uma piada de 1 de abril de 1998 (protocolo de cafeteiras). Não tem uso sério mas tornou-se uma piada de culto, e alguns servidores devolvem-no para pedidos disparatados.