Neste artigo
O que são códigos de status HTTP?
Os códigos de status HTTP são números de três dígitos retornados pelos servidores web em resposta a uma solicitação do cliente. Eles indicam se a solicitação foi bem-sucedida, redirecionada, resultou em erro ou requer ação adicional. Toda vez que você carrega uma página web, seu navegador recebe um desses códigos.
Os códigos de status são definidos pela especificação HTTP (RFC 7231 e RFCs relacionadas) e são agrupados em cinco classes com base no primeiro dígito. Compreender esses códigos é essencial para desenvolvedores web, designers de API e qualquer pessoa que depure aplicações web.
As cinco categorias de códigos de status
Os códigos de status HTTP são organizados em cinco categorias, cada uma indicando um tipo diferente de resposta.
- 1xx Informativo — a solicitação foi recebida e o processamento continua (ex.: 100 Continue, 101 Switching Protocols)
- 2xx Sucesso — a solicitação foi recebida, compreendida e aceita com sucesso (ex.: 200 OK, 201 Created, 204 No Content)
- 3xx Redirecionamento — ação adicional é necessária para completar a solicitação (ex.: 301 Moved Permanently, 302 Found, 304 Not Modified)
- 4xx Erro do cliente — a solicitação contém sintaxe incorreta ou não pode ser atendida (ex.: 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found)
- 5xx Erro do servidor — o servidor falhou ao atender uma solicitação válida (ex.: 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable)
Experimente gratuitamente — sem cadastro
Pesquisar códigos de status →Quando usar uma referência de códigos de status HTTP
Conhecer o código de status correto para retornar ou esperar é crucial para construir serviços web confiáveis.
- Desenvolvimento de API — escolher o código de resposta correto para cada endpoint (201 para criação, 204 para exclusão, 422 para erros de validação)
- Depuração — diagnosticar problemas quando as solicitações falham (é um problema de autenticação 401 ou de autorização 403?)
- SEO e monitoramento — rastrear redirecionamentos 301/302, identificar links quebrados 404 e monitorar erros do servidor 5xx
Perguntas frequentes
Qual é a diferença entre 401 e 403?
401 Unauthorized significa que o cliente não forneceu credenciais de autenticação válidas — o usuário precisa fazer login ou fornecer uma chave de API. 403 Forbidden significa que o cliente está autenticado, mas não tem permissão para acessar o recurso. Em resumo: 401 = ‘quem é você?’, 403 = ‘eu sei quem você é, mas você não pode acessar isso.’
Quando devo usar redirecionamentos 301 vs 302?
Use 301 Moved Permanently quando o recurso foi movido permanentemente para uma nova URL — os motores de busca atualizarão seu índice. Use 302 Found (ou 307 Temporary Redirect) quando o redirecionamento é temporário e a URL original ainda deve ser usada no futuro. Usar o código errado pode prejudicar o SEO.
O que significa um erro 500 Internal Server Error?
Um erro 500 é um erro genérico do lado do servidor indicando que algo deu errado ao processar a solicitação, mas o servidor não pode ser mais específico. Causas comuns incluem exceções não tratadas no código da aplicação, falhas de conexão com o banco de dados, servidores mal configurados ou problemas de implantação. Verifique os logs do servidor para obter os detalhes reais do erro.