Códigos de status HTTP explicados, do 200 ao 503
Toda vez que o seu navegador pede algo a um servidor web, o servidor responde com um número de três dígitos antes de enviar qualquer HTML, imagem ou JSON. Esse número é o código de status HTTP, e é a forma curta que o servidor tem de dizer o que aconteceu: a página está aqui, ela mudou de lugar, você não tem permissão de entrar ou algo quebrou do nosso lado. Na maior parte do tempo você nunca vê esses códigos, porque tudo funciona e a página simplesmente carrega. Mas no momento em que um site dá problema, o código de status é a primeira pista que vale a pena ler.
Os números não são aleatórios. O primeiro dígito classifica cada resposta em uma de cinco famílias, então até um código desconhecido já indica mais ou menos o que deu errado só pelo seu dígito inicial. Aprenda as cinco famílias e você conseguirá ler quase qualquer resposta de relance.
As cinco classes
1xx informativo. O servidor recebeu sua requisição e ainda está processando. Esses são raros na navegação do dia a dia e costumam ser tratados silenciosamente entre o navegador e o servidor. 100 Continue é o exemplo clássico, dizendo ao cliente que ele pode enviar o restante de um corpo de requisição grande.
2xx sucesso. A requisição funcionou. 200 OK é o que você quer ver o dia inteiro, significando que o recurso foi encontrado e está a caminho de volta. 201 Created aparece depois que você envia um formulário ou uma chamada de API que cria algo novo, e 204 No Content significa que a ação teve sucesso, mas não há nada para exibir.
3xx redirecionamento. O que você pediu mora em outro lugar, e o navegador normalmente segue automaticamente. Os redirecionamentos mantêm links antigos vivos e fazem muita diferença no ranqueamento de busca.
4xx erro do cliente. Algo na requisição estava errado do seu lado: uma URL incorreta, login ausente ou um recurso que não existe. O servidor está saudável; ele só não consegue aceitar o que você enviou.
5xx erro do servidor. Sua requisição estava certa, mas o servidor tropeçou ao processá-la. Esses códigos apontam para a infraestrutura do site, não para você.
Os códigos específicos que as pessoas realmente pesquisam
200 OK é o sucesso puro e simples. A página ou os dados carregaram como esperado.
301 Moved Permanently diz aos navegadores e aos mecanismos de busca que uma página tem um novo endereço permanente. É o redirecionamento amigável ao SEO, porque transfere os sinais de ranqueamento da URL antiga para a nova. Use-o quando mudar uma URL de forma definitiva.
302 Found é um redirecionamento temporário. A URL original ainda é a verdadeira, então os mecanismos de busca continuam indexando-a em vez do destino. Recorra ao 302 apenas quando a mudança for genuinamente passageira, como direcionar usuários a uma página sazonal.
304 Not Modified é um herói discreto da navegação rápida. Ele diz ao navegador que a cópia já presente em seu cache continua atual, então o servidor evita reenviar o arquivo. Menos dados, páginas mais rápidas.
400 Bad Request significa que o servidor nem conseguiu entender a requisição, muitas vezes por causa de sintaxe malformada ou de um parâmetro inválido.
401 Unauthorized se traduz, grosso modo, como "não sei quem você é, por favor autentique-se." Faltam credenciais válidas.
403 Forbidden é diferente: o servidor sabe quem você é e mesmo assim recusa. Você não tem permissão, e fazer login de novo não vai ajudar.
404 Not Found é o código mais famoso de todos. O servidor está vivo e respondeu, mas não há nada naquele endereço. Normalmente vem de um link digitado errado ou de uma página que foi apagada ou movida sem redirecionamento.
429 Too Many Requests significa que você atingiu o limite de taxa. Você enviou requisições demais em um intervalo curto demais, e o servidor está pedindo para você diminuir o ritmo. As APIs usam isso o tempo todo.
500 Internal Server Error é a resposta genérica de "algo quebrou". O servidor encontrou uma condição inesperada e desistiu, mas não diz o quê. Verifique os logs do servidor.
502 Bad Gateway aparece quando um servidor, atuando como gateway ou proxy, recebe uma resposta inválida de um servidor upstream por trás dele. Muitas vezes é sinal de que uma aplicação de backend caiu ou está inacessível.
503 Service Unavailable significa que o servidor está temporariamente sobrecarregado ou fora do ar para manutenção. Ao contrário do 500, ele dá a entender que o problema é de curto prazo e que o site deve voltar em breve.
O que os códigos de status significam para SEO e depuração
Para o ranqueamento de busca, a distinção entre 301 e 302 é a que mais confunde as pessoas. Uma mudança permanente deve sempre usar 301, para que a nova página herde a autoridade da antiga; um 302 no lugar errado pode deixar os mecanismos de busca indexando a URL original e dividindo seus sinais. Enquanto isso, um grande número de 404s desperdiça orçamento de rastreamento e frustra os visitantes, então vale a pena redirecionar ou consertar links quebrados em vez de deixá-los apodrecer.
Para depuração, a família indica onde procurar. Um 4xx aponta para a requisição, então verifique a URL, os cabeçalhos e as credenciais. Um 5xx aponta para o servidor, então verifique os logs da aplicação, os serviços upstream e se um deploy acabou de dar errado. Uma onda de 502s e 503s costuma significar que um backend está fora do ar ou sobrecarregado, em vez de um bug no código. Você pode inspecionar o status exato que um site retorna com nossas ferramentas de desenvolvedor, e quando um 5xx parecer um problema de conectividade em vez de uma falha de aplicação, uma rápida consulta DNS pode confirmar se o domínio ainda resolve para o endereço certo.
Perguntas frequentes
Um erro 404 é ruim para o meu site?
Alguns 404s são normais e inofensivos. Os problemas começam quando páginas populares retornam 404 ou quando links internos quebrados se acumulam, desperdiçando orçamento de rastreamento e frustrando os visitantes. Redirecione páginas movidas e corrija links ruins.
Qual é a diferença entre um redirecionamento 301 e um 302?
Um 301 é permanente e transfere sinais de ranqueamento para a nova URL, então use-o quando uma página muda de vez. Um 302 é temporário e mantém a URL original indexada, então use-o apenas para mudanças passageiras.
Qual é a diferença entre 401 e 403?
Um 401 significa que você não se autenticou, então fazer login pode resolver. Um 403 significa que o servidor reconhece você, mas ainda assim nega o acesso porque você não tem permissão, então fazer login de novo não vai ajudar.
O que significa um erro 500 e como eu o corrijo?
Um 500 Internal Server Error significa que o servidor encontrou uma falha inesperada ao processar sua requisição. A mensagem é genérica de propósito, então a correção geralmente começa lendo os logs do servidor para encontrar a causa real.
Por que estou recebendo um código de status 429?
Um 429 Too Many Requests significa que você atingiu o limite de taxa por enviar requisições rápido demais. Diminua o ritmo, respeite qualquer cabeçalho Retry-After que o servidor retornar e adicione backoff a scripts e clientes de API.
O que significa 503 Service Unavailable?
Um 503 significa que o servidor está temporariamente incapaz de tratar a requisição, geralmente por sobrecarga ou manutenção programada. Ele sinaliza um problema de curto prazo, então o site deve se recuperar sozinho em breve.