Grupos de códigos de status
1xx informativo
A requisição ainda está em andamento. Esses códigos são incomuns na depuração normal do navegador.
2xx sucesso
A requisição foi bem-sucedida. 200, 201, e 204 aparecem com mais frequência.
3xx redirecionamento
O cliente precisa seguir outra URL ou usar conteúdo em cache.
Erro do cliente 4xx
A requisição era inválida, não autorizada, ausente ou limitada por taxa.
Erro do servidor 5xx
O servidor falhou ao tentar processar uma requisição válida.
Códigos comuns que você realmente usa
| Código | Significado | Caso típico |
|---|---|---|
| 200 | OK | Resposta normal bem-sucedida a GET ou POST |
| 201 | Criado | Recurso criado com sucesso após POST |
| 301 | Movido Permanentemente | URL alterada permanentemente, atualize links e destinos canônicos |
| 302 | Encontrado | Redirecionamento temporário, geralmente login ou roteamento de curto prazo |
| 400 | Requisição inválida | Payload malformado ou parâmetro obrigatório ausente |
| 401 | Não autorizado | Autenticação ausente ou inválida |
| 403 | Proibido | Autenticado, mas sem permissão para acessar este recurso |
| 404 | Não encontrado | Rota, arquivo ou recurso não existe |
| 429 | Muitas requisições | Limite de requisições excedido |
| 500 | Erro interno do servidor | Falha não tratada no servidor |
Checklist rápido de depuração
- Se o código for 4xx, verifique a requisição primeiro: autenticação, formato do payload, URL, cabeçalhos.
- Se o código for 5xx, verifique primeiro o servidor e os logs.
- Se o código for 301 ou 302, verifique para onde o redirecionamento leva e se esse comportamento é intencional.
- Se o código for 429, adicione lógica de nova tentativa ou backoff em vez de sobrecarregar o endpoint.
Use esta referência com a ferramenta adequada
Ferramentas relacionadas