TECNOLANDIA TECH
Publicidade

Conecte-se com o Tecnolândia Tech

BLOG + INSTAGRAM + FACEBOOK

Tecnologia na prática, em todos os formatos.

Aqui no Tecnolândia Tech, você encontra artigos e guias completos. No Instagram @djwinformatica e no Facebook TecnoInfo, acompanhe vídeos, dicas e novidades de IA, automação e tecnologia. São nossos canais oficiais.

HTTP: O Que São os Códigos 200, 404 e 500

HTTP: O Que São os Códigos 200, 404 e 500

Imagem: Unsplash

O que é um código de status

Toda resposta HTTP começa com um número de três dígitos. Ele diz, em resumo, o que aconteceu com o pedido. O primeiro dígito define a família; os outros dois detalham. Saber ler esse número economiza horas de depuração, porque separa problema do cliente, do servidor e da rede.

FamíliaSignificadoExemplos
1xxInformativo100, 101
2xxSucesso200, 201, 204
3xxRedirecionamento301, 302, 304
4xxErro do cliente400, 401, 403, 404, 429
5xxErro do servidor500, 502, 503, 504

200, 201 e 204

200 OK é o caso feliz: a requisição funcionou e há corpo na resposta. 201 Created confirma criação; costuma vir com o cabeçalho Location apontando para o novo recurso. 204 No Content indica sucesso sem corpo, comum em DELETE e em atualizações que não retornam dados.

301 e 304

301 Moved Permanently transfere a URL de forma definitiva; navegadores e buscadores passam a usar o novo endereço. 304 Not Modified responde a uma requisição condicional: o recurso não mudou e o cliente pode usar o cache. Bem configurado, reduz tráfego e melhora desempenho.

400, 401, 403, 404 e 429

400 indica pedido malformado. 401 significa não autenticado: falta credencial ou ela é inválida. 403 é autenticado, mas sem permissão. 404 diz que o recurso não existe — ou foi escondido de propósito. 429 avisa que você passou do limite de requisições; respeite o cabeçalho Retry-After.

Confundir 401 com 403 é comum. Se o token está ausente ou vencido, 401. Se o token é válido mas o usuário não pode acessar, 403.

500, 502, 503 e 504

500 é erro interno não tratado. 502 indica resposta inválida de um servidor intermediário (proxy ou gateway). 503 significa indisponível, muitas vezes por sobrecarga ou manutenção. 504 é timeout do gateway esperando o servidor de origem. Para quem consome a API, 502 e 504 costumam pedir retentativa com espera; 500 pede investigação.

Como diagnosticar no dia a dia

No navegador, abra o DevTools, aba Network, e veja status, cabeçalhos e corpo. No terminal, curl -I https://exemplo.com mostra só os cabeçalhos; curl -i inclui o corpo. Registre o status nos logs com a rota e o tempo de resposta: sem isso, você descobre o problema tarde.

Erros comuns de interpretação

Tratar todo 4xx como “culpa do usuário” ignora bugs de contrato. Mascarar 400 como 500 dificulta a correção. Ignorar 429 e insistir na requisição piora o bloqueio. E confiar em 200 sem validar o corpo esconde falhas de negócio.

Escolha do código certo

Uma regra prática evita a maior parte das dúvidas: criou algo? 201. Deu certo sem corpo? 204. Pedido inválido? 400 (ou 422 quando a sintaxe está certa e o conteúdo não). Falta autenticação? 401. Autenticado sem permissão? 403. Não existe? 404. Excedeu limite? 429. Falha inesperada no servidor? 500. Ser consistente importa mais que acertar o código perfeito em cada caso.

Status e observabilidade

Registre o status em todo log de requisição, junto com rota, latência e identificador de correlação. Monitore a proporção de 5xx e alerte quando passar do normal; acompanhe 429 para ajustar limites. Sem essa visão, um 500 esporádico vira incidente grande. Status bem instrumentado é diagnóstico, não só resposta.

Leitura do TECNOLANDIA

Código de status é contrato, não detalhe. Um 401 mal usado confunde o front, um 500 que esconde 400 atrasa a correção e um 429 ignorado derruba a integração. Quem projeta API com semântica correta economiza suporte e ganha confiança de quem consome. Aprender as cinco famílias leva uma tarde e rende anos.

Leia também

Fontes e leitura recomendada

Publicado em 10/11/2026 · TECNOLANDIA TECH

Transparência: conteúdo editorial, sem links de afiliado. Como produzimos · Política de afiliados · Contato

Publicidade