Códigos de Status HTTP

401 Unauthorized significa que autenticação é necessária — o servidor não sabe quem você é. Geralmente vem com um cabeçalho WWW-Authenticate pedindo para você fazer login. 403 Forbidden significa que o servidor sabe quem você é (ou a autenticação não é o problema), mas você não tem permissão. Pense em 401 como "mostre sua identificação" e em 403 como "vejo sua identificação, mas você não está na lista."

Um 502 aparece quando um proxy, balanceador de carga ou CDN recebe uma resposta inválida do servidor upstream que contactou em seu nome. Causas comuns: o servidor upstream travou, está sobrecarregado, reiniciou durante a requisição ou retornou cabeçalhos HTTP malformados. O proxy em si está funcionando — é o que o proxy está acessando que está com problema. Verifique os logs do servidor de aplicação e reinicie-o se necessário.

301 Moved Permanently informa a navegadores e mecanismos de busca que o recurso foi movido permanentemente — eles devem atualizar os favoritos e transferir o valor dos links. 302 Found é temporário — os clientes devem continuar usando a URL original. Para SEO, sempre use 301 para mudanças permanentes de URL. Usar 302 por engano em uma movimentação permanente pode dividir seus sinais de ranqueamento e causar propagação lenta.

418 é uma brincadeira de Primeiro de Abril da RFC 2324 (1998) — o Hyper Text Coffee Pot Control Protocol. A premissa: um servidor que é, de fato, um bule de chá deve recusar-se a preparar café com este código. Foi uma RFC satírica de Larry Masinter. Apesar de nunca ter sido um erro real, sobreviveu no registro da IANA e se tornou uma tradição amada no desenvolvimento web. Alguns servidores o usam para rejeitar humoristicamente bots ou automações indesejadas.

429 significa que você excedeu um limite de taxa — enviando muitas requisições em pouco tempo. Para corrigir como cliente: aguarde e tente novamente após o delay especificado no cabeçalho Retry-After, implemente backoff exponencial e armazene respostas em cache quando possível. Como servidor: sempre inclua um cabeçalho Retry-After; use algoritmos de janela deslizante ou token bucket para limitação justa de taxa.

Use 404 Not Found quando o recurso não existe, mas pode existir futuramente (ou você não tem certeza se já existiu). Use 410 Gone quando você sabe que o recurso existia anteriormente e foi excluído permanentemente sem substituto. Para SEO, 410 sinaliza aos mecanismos de busca para remover a URL do índice mais rapidamente que 404.