Resumo Executivo: Os códigos de status HTTP são a linguagem padrão que os servidores usam para responder às solicitações dos clientes. Dominá-los é indispensável para construir APIs REST resilientes.
O que são Códigos de Status HTTP?
Quando um navegador ou aplicação envia uma requisição HTTP para um servidor, este retorna um código numérico de 3 dígitos acompanhado de uma mensagem de status. Os códigos são divididos em 5 famílias principais:
As 5 Famílias de Códigos HTTP
| Faixa | Categoria | Significado | Exemplo Famoso |
|---|---|---|---|
| 1xx | Informativo | A requisição foi recebida e o processo continua | 100 Continue |
| 2xx | Sucesso | A requisição foi processada com sucesso | 200 OK, 201 Created |
| 3xx | Redirecionamento | Ações adicionais são necessárias para concluir a requisição | 301 Moved Permanently |
| 4xx | Erro do Cliente | A requisição contém sintaxe incorreta ou não autorizada | 404 Not Found, 401 Unauthorized |
| 5xx | Erro do Servidor | O servidor falhou ao processar uma requisição válida | 500 Internal Server Error |
Os Códigos Mais Utilizados em APIs REST
200 OK & 201 Created
* 200 OK: Resposta padrão para requisições bem-sucedidas de busca (GET) ou atualização (PUT/PATCH).
* 201 Created: Retornado após a criação bem-sucedida de um novo recurso no banco de dados (POST).
401 Unauthorized vs 403 Forbidden
* 401 Unauthorized: O usuário não está autenticado (falta o token JWT ou cookie de sessão).
* 403 Forbidden: O usuário está autenticado, mas não possui permissão de acesso ao recurso (ex: um cliente comum tentando acessar a área administrativa).
404 Not Found & 422 Unprocessable Entity
* 404 Not Found: O recurso ou página solicitada não foi encontrada na URL informada.
* 422 Unprocessable Entity: Usado frequentemente por APIs modernas quando a requisição é válida, mas os dados falharam na validação de negócios (ex: e-mail inválido).
Verificador de IP e Rede
Verifique a comunicação de rede e detalhes do servidor.
Rennan Silva
Autor EspecialistaEngenheiro de Software & Especialista em Segurança Web
Especialista em arquitetura web, segurança da informação e performance front-end. Criador de conteúdos técnicos e ferramentas abertas para a comunidade dev.