// reference
HTTP Status Codes.
Searchable reference of every HTTP status code (1xx through 5xx) with description, semantics, and typical usage. Filter by category or search by code number.
Perguntas frequentes
O que significam os códigos 2xx?
Sucesso: 200 OK, 201 Criado, 204 Sem conteúdo, entre outros.
Quando usar 404 vs 410?
404 = não encontrado (pode existir depois); 410 = removido permanentemente.
O que significam os códigos 5xx?
Erro do servidor: 500 erro interno, 502 bad gateway, 503 indisponível.
O que são códigos de status HTTP
Códigos de status HTTP são números de 3 dígitos que indicam o resultado de uma requisição HTTP. Eles comunicam se a requisição foi bem-sucedida, redirecionada, ou encontrou um erro.
Cada código tem um significado padronizado pela IANA e é interpretado por clientes e servidores de forma consistente em toda a web.
Entender códigos de status é essencial para desenvolvimento web, APIs e debugging, pois eles são a forma primária de comunicação sobre o resultado de requisições.
Categorias explicadas
1xx (Informacional): a requisição foi recebida e o processo está em andamento. Ex: 100 Continue, 101 Switching Protocols.
2xx (Sucesso): a requisição foi recebida, processada e aceita com sucesso. Ex: 200 OK, 201 Created, 204 No Content.
3xx (Redirecionamento): mais ações são necessárias para completar a requisição. Ex: 301 Moved Permanently, 304 Not Modified.
4xx (Erro do Cliente): a requisição contém sintaxe incorreta ou não pode ser processada. Ex: 400 Bad Request, 401 Unauthorized, 404 Not Found.
5xx (Erro do Servidor): o servidor falhou em processar uma requisição válida. Ex: 500 Internal Server Error, 503 Service Unavailable.
Códigos mais comuns
200 OK: sucesso padrão para GET requests. O body contém o recurso solicitado.
201 Created: recurso foi criado com sucesso, geralmente em resposta a POST requests. O header Location pode conter a URL do novo recurso.
400 Bad Request: o servidor não pode processar a requisição devido a erro do cliente (sintaxe, dados inválidos).
401 Unauthorized: autenticação é necessária. O cliente não forneceu credenciais válidas.
404 Not Found: o recurso solicitado não existe no servidor.
500 Internal Server Error: erro genérico do servidor, geralmente indicando bug ou problema de configuração.