← Artigos

HTTP FIELD GUIDE

Como ler os códigos de status HTTP

Diferencie sucesso, erro do cliente e erro do servidor pelos códigos.

Comece pela classe

O primeiro dígito indica o resultado geral: 2xx é sucesso, 3xx redirecionamento ou ação adicional, 4xx problema do cliente e 5xx falha do servidor. Um 404 ainda é uma resposta HTTP completa. Um erro de rede pode não ter status HTTP.

Leia o código exato

401 geralmente indica autenticação necessária ou inválida; 403 significa acesso negado. 404 é recurso não encontrado, enquanto 405 é método não permitido e deve incluir o cabeçalho Allow. 429 indica limite de requisições e pode trazer Retry-After.

Investigue o contexto

Confira os cabeçalhos e o corpo, não apenas o número. Um 200 pode conter erro de aplicação, enquanto 204 não tem corpo. Redirecionamentos podem mudar a URL final. Quando CORS falha, o navegador pode ocultar a resposta HTTP: compare a requisição com a política CORS da API.

Referências