Todo desenvolvedor mantém uma lista mental de códigos de status HTTP. O meu costumava ser 200, 404 e 500, e por muito tempo isso foi suficiente para falsificar competência Então EU passei uma semana construindo uma integração de pagamento onde a API retornou 402 para um cartão recusado, 409 quando EU tentei novamente uma cobrança que já havia passado, e 429 quando meus testes martelaram muito rápido De repente, a diferença entre os códigos era a diferença entre um recurso de trabalho e um ticket de suporte Eu construo um monte de ferramentas da web para Toolz.dev, e uma referência de código de status pesquisável é uma daquelas coisas que busco constantemente, então incorporei uma no site e escrevi este guia para acompanhá-la.
tl;dr: Um código de status HTTP é um número de três dígitos que um servidor envia de volta para descrever o resultado de uma solicitação O primeiro dígito define a classe: 1 xx informacional, 2 xx sucesso, 3 xx redirecionamento, 4 xx erro do cliente, 5 xx erro do servidor Olhe qualquer um deles para cima instantaneamente com o Ferramenta de códigos de status HTTP, que permite pesquisar por número, nome ou palavra-chave e cita a RFC que define cada um.
Este guia aborda o que são códigos de status, o que cada classe significa, os códigos específicos que valem a pena memorizar e aqueles que as pessoas mais erram. Destina-se a desenvolvedores front-end que depuram chamadas de API, desenvolvedores back-end que decidem o que retornar e qualquer pessoa que faça SEO técnico e precise de redirecionamentos para se comportar.
O que é um código de status HTTP?
Sempre que o seu navegador ou uma aplicação solicita algo através da Web, o servidor responde com uma resposta A primeira linha dessa resposta contém um código de estado: um número de três dígitos, emparelhado com uma frase de razão curta como o & quot; OK & quot; ou o & quot; Não Encontrado & quot; O código é o resumo legível por máquina do que aconteceu, e a frase de razão é o rótulo amigável para humanos Os clientes agem sobre o número; a frase é para pessoas que leem logs.
Os códigos de status são definidos pela Internet Engineering Task Force, principalmente na RFC 9110, que consolidou as especificações HTTP mais antigas em 2022. um registro central mantido pela IANA lista todos os códigos oficialmente reconhecidos. Essa padronização é o que permite que um navegador escrito por uma empresa converse com um servidor escrito por outra e concorde com o que significa um 404. O Ferramenta de códigos de status HTTP espelha esse registro, listando cada código padrão com seu significado e a RFC que o define.
O modelo mental chave é que o primeiro dígito lhe diz a categoria, e a categoria diz quem é o responsável Um código 4 xx significa que o cliente enviou algo errado Um código 5 xx significa que o servidor falhou em uma solicitação que estava bem Essa única distinção resolve a maioria dos argumentos de depuração sobre de quem é o bug.
O que significam as cinco classes de código de status?
Existem exatamente cinco classes, agrupadas pelo dígito principal Entender a classe é mais valioso do que memorizar códigos individuais, porque diz onde procurar.
A classe 1 xx é informativa Esses códigos sinalizam que o servidor recebeu a solicitação e o processamento continua Eles são raros no trabalho diário O mais conhecido é 100 Continue, e o mais útil moderno é 103 Early Hints, que permite que um servidor diga ao navegador para iniciar o pré-carregamento de recursos antes que a resposta completa esteja pronta.
A classe 2 xx significa sucesso O pedido foi recebido, compreendido e aceite.200 OK é o código de sucesso diário, 201 Criado confirma que um novo recurso foi feito, e 204 Nenhum Conteúdo diz & quot; feito, nada para enviar de volta & quot;, o que é comum para operações de exclusão.
A classe 3 xx é redirecionamento O recurso vive em outro lugar, ou não mudou desde a última vez que o cliente viu Esta classe é onde o SEO vive, porque 301 e 302 dizem aos motores de busca se um movimento é permanente 304 Not Modified é um cavalo de batalha de cache que economiza enorme largura de banda.
A classe 4 xx é um erro do cliente A solicitação foi malformada, não autorizada ou apontada para algo que não existe. 400, 401, 403, 404 e 429 vivem aqui. Quando você vir um 4 xx, verifique qual é o seu código enviado antes de culpar o servidor.
A classe 5 xx é um erro do servidor A solicitação era válida, mas o servidor não conseguiu atendê-la. 500, 502, 503 e 504 são aqueles que você encontrará em incidentes de produção, geralmente apontando para uma falha, um serviço sobrecarregado ou uma dependência upstream quebrada.
Quais códigos de status HTTP todo desenvolvedor deve saber?
Você não precisa de todos os mais de sessenta códigos em sua cabeça Você precisa de talvez quinze, e o resto você olha para cima Aqui está o conjunto de trabalho EU acho que ganha um lugar permanente na memória, com as situações que os desencadeiam.
| Código | sentido | Quando você vê |
|---|---|---|
| 200 | OK | Um pedido normal bem sucedido |
| 201 | Criado | Um POST ou PUT criou um novo recurso |
| 204 | Sem Conteúdo | Sucesso com um corpo vazio, comum após DELETE |
| 301 | Movido Permanentemente | Um URL movido para sempre; Transferências de classificação de SEO |
| 302 | Encontrado | Um redirecionamento temporário; continue usando o URL antigo |
| 304 | Não Modificado | A cópia em cache ainda é válida; nenhum corpo enviado |
| 400 | Pedido ruim | Sintaxe malformada ou enquadramento de solicitação inválido |
| 401 | Não autorizado | Autenticação ausente ou falhada |
| 403 | Proibido | Autenticado, mas não permitido |
| 404 | Não Encontrado | O recurso não existe |
| 409 | Conflito | O pedido entra em conflito com o estado atual |
| 422 | Conteúdo não processável | Sintaxe válida, regras de validação falhadas |
| 429 | Pedidos Demasiados | Taxa limitada; recuar e tentar novamente |
| 500 | Erro interno do servidor | Falha inesperada do servidor |
| 503 | Serviço Indisponível | Servidor sobrecarregado ou em manutenção |
Vale a pena reconhecer o restante do registro, de 226 IM Usado a 451 Indisponível por motivos legais, mas não memorizar. É exatamente para isso que serve uma ferramenta de pesquisa.
Qual é a diferença entre 401 e 403?
Este par tropeça em quase todos, por isso merece sua própria seção Ambos significam que o acesso foi negado, mas por razões diferentes, e a diferença muda a forma como seu aplicativo deve responder.
Um 401 Não autorizado significa que a solicitação não possui autenticação válida O servidor não sabe quem você é Ou você não enviou credenciais, ou as que você enviou estavam erradas ou expiraram A resposta correta do seu lado é fazer login ou atualizar o token Por especificação, uma resposta 401 deve incluir um cabeçalho WWW-Authenticate informando ao cliente como se autenticar.
Um 403 Proibido significa que o servidor sabe exatamente quem você é e está recusando de qualquer maneira Você está autenticado, mas não autorizado para este recurso em particular Faz login novamente não vai ajudar, porque o problema são permissões, não identidade Um usuário regular batendo um endpoint apenas de administrador deve obter um 403.
A regra rápida que uso: 401 é o & quot; quem é você?", 403 é o & quot; Eu sei quem você é, e o no" Se você estiver construindo uma API e quiser gerar os cabeçalhos de Autorização para testar esses fluxos, o Gerador de autenticação básico produz as credenciais codificadas que você precisa.
Por que os redirecionamentos 301 versus 302 são importantes para SEO?
Os redirecionamentos são onde os códigos de status deixam de ser um detalhe interno da implementação e começam a afetar seus rankings de pesquisa Quando você move uma página, o código de status que você retorna informa aos mecanismos de pesquisa o que fazer com a antiga autoridade acumulada do URL' s.
Um 301 Moved Permanentemente sinaliza que o movimento é final Os motores de busca deixam cair o URL antigo de seu índice ao longo do tempo, passam os sinais de classificação para o novo URL e atualizam seus links Este é o código que você deseja quando renomear uma página, migrar para HTTPS ou consolidar URLs duplicados Usar corretamente é uma das correções mais comuns em uma auditoria técnica de SEO.
Um 302 Found sinaliza um movimento temporário Os mecanismos de pesquisa mantêm o URL original indexado porque você disse a eles que a mudança não é permanente Se você usar um 302 para um movimento que é permanente, você pode encalhar sua classificação em um URL que não tenho visto sites perderem visibilidade por meses porque um framework padronizado para redirecionamentos 302 durante uma migração HTTPS.
Há também 307 Redirecionamento Temporário e 308 Redirecionamento Permanente, que se comportam como 302 e 301, mas garantem que o método e o corpo HTTP sejam preservados Use 307 e 308 para solicitações não-GET onde alterar o método quebraria as coisas Se você estiver auditando como os rastreadores veem seu site, emparelhe esse conhecimento com o Gerador de Robôs.txt e o Gerador de meta tags para ter certeza de que toda a imagem de rastreamento e redirecionamento é consistente. O Kit de ferramentas para desenvolvedores web guia amarra essas peças.
Quais são os códigos de erro de servidor mais comuns e como você os depura?
A classe 5 xx é onde os incidentes de produção vivem, e cada código aponta para você em uma camada diferente da pilha Sabendo qual é o que economiza tempo real durante uma interrupção.
Um Erro de Servidor Interno 500 é o genérico catch-all Significa que o código da sua aplicação lançou uma excepção não tratada ou atingiu uma condição que não podia processar A correcção está quase sempre nos seus próprios registos Um 500 é o servidor a dizer & quot; algo falhado e não tenho melhor palavra para ele", por isso o código diz-lhe onde procurar mas não o que correu mal.
Um 502 Bad Gateway e um 504 Gateway Timeout ambos vêm de um servidor atuando como um gateway ou proxy, como um balanceador de carga ou um proxy reverso na frente do seu aplicativo Um 502 significa que o upstream enviou de volta algo inválido, muitas vezes porque seu aplicativo travou ou não está em execução Um 504 significa que o upstream levou muito tempo para responder e o gateway desistiu de esperar Se você correr atrás do Nginx, um CDN ou um balanceador de carga na nuvem, esses são os códigos que você verá quando a coisa por trás do proxy não for saudável.
Um Serviço 503 Indisponível significa que o servidor está temporariamente incapaz de lidar com a solicitação, geralmente porque está sobrecarregado ou em manutenção As respostas 503 bem comportadas incluem um cabeçalho Retry-After informando aos clientes quando voltar Enviar um 503 durante a manutenção planejada é a maneira correta e segura de SEO de derrubar um site brevemente, porque ele diz aos mecanismos de pesquisa para voltar mais tarde, em vez de assumir que as páginas desapareceram Para uma visão mais ampla do diagnóstico de problemas da web, o Ferramentas de produtividade do desenvolve o guia cobre o kit de ferramentas mais amplo.
E os códigos de status menos comuns?
Além do conjunto funcional, o registro contém uma longa cauda de códigos que você encontrará ocasionalmente, e reconhecê-los economiza meia hora confusa. Alguns valem um passeio rápido.
Na família 2 xx, o 206 Partial Content alimenta downloads e streaming de vídeo retomáveis Quando um cliente envia um cabeçalho Range solicitando bytes 500 a 999 de um arquivo, o servidor responde 206 apenas com essa fatia É assim que um download pausado é retomado em vez de recomeçar, e como um navegador procura o meio de um vídeo sem buscar a coisa toda primeiro.
Na família 4 xx, 410 Gone é uma versão mais forte e deliberada do 404. onde o 404 diz & quot; Não consegui encontrá-lo & quot;, o 410 diz & quot; estava aqui, desapareceu permanentemente, pare de pedir & quot; O uso do 410 para conteúdo que você removeu intencionalmente ajuda os mecanismos de busca a descartá-lo mais rápido do que um 404 faria Outro útil é o 451 Indisível por Razões Legais, cujo número é um aceno para o romance Fahrenheit 451, retornado quando o conteúdo é bloqueado por uma ordem legal, como uma remoção ou uma liminar judicial.
Há também 418 I & #39; m a Teapot, um código registrado real de uma especificação April Fools de 1998 que um bule retorna quando solicitado a preparar café Não é usado para o tráfego normal, mas aparece como um ovo de páscoa em algumas APIs, e é um pequeno lembrete de que as pessoas que escreveram esses padrões tinham um senso de humor A ferramenta lista tudo isso para que você possa procurar qualquer coisa que tropeçar sem adivinhar.
Como a ferramenta Códigos de Status HTTP ajuda?
A ferramenta é deliberadamente simples, porque o trabalho é simples: você tem um código ou um sintoma, e você quer o significado rápido Você pode pesquisar pelo número, pela frase de razão como & quot; não encontrado", ou por uma palavra-chave da descrição como & quot; redirect" ou & quot; rate limit" Você pode filtrar para uma única classe para navegar apenas pelos redirecionamentos ou apenas pelos erros do servidor Cada entrada mostra a frase de razão, uma explicação simples de quando o código se aplica e o RFC que o define, para que você possa confirmar o comportamento em relação à fonte primária.
Como todo o registro carrega em seu navegador, a pesquisa é instantânea e funciona offline assim que a página está aberta Nada do que você pesquisa é enviado para qualquer lugar É o tipo de referência que mantenho fixada em uma guia enquanto construo uma API, bem ao lado da Analisador de agente do usuário para inspecionar cabeçalhos de solicitação.
Perguntas frequentes
Quais são as cinco classes de códigos de status HTTP?
Os códigos de status HTTP são agrupados por seu primeiro dígito: 1 xx informacional, 2 x x sucesso, 3 xx redirecionamento, 4 xx erro do cliente, e 5 xx erro do servidor A classe diz-lhe em um relance se um pedido teve sucesso, foi redirecionado, ou falhou no lado do cliente ou servidor, o que geralmente é suficiente para saber onde começar a depuração.
O que significa um código de status 404?
Um 404 Not Found significa que o servidor não conseguiu encontrar o recurso solicitado O URL pode estar escrito incorretamente, a página pode ter sido excluída ou o link pode estar quebrado É um código de erro do cliente, então a solicitação chegou ao servidor, mas apontou para algo que não existe lá.
Qual é a diferença entre um redirecionamento 301 e 302?
Um 301 Moved Permanently diz aos clientes e motores de busca que o recurso se moveu para sempre, para que eles atualizem seus links e transfiram sinais de classificação para o novo URL. Um 302 Found é um redirecionamento temporário, portanto, o URL original deve continuar sendo usado para solicitações futuras e os mecanismos de pesquisa o mantêm indexado.
O que significa um erro interno do servidor 500?
Um Erro de Servidor Interno 500 é uma mensagem genérica significando que o servidor atingiu uma condição inesperada que não poderia lidar Ele sinaliza um problema no servidor em vez da solicitação, então a correção geralmente está no código ou configuração do aplicativo, e seus próprios logs do servidor são o lugar para procurar.
Quando uma API deve retornar 400 versus 422?
Retorne 400 Solicitação incorreta quando a solicitação em si estiver malformada, como JSON inválido ou um cabeçalho necessário ausente. Retorne 422 Conteúdo não processável quando a sintaxe for válida, mas os dados falharem nas regras de negócios ou validação, como um e-mail já retirado ou um valor fora do alcance.
O que é um código 429 Too Many Requests?
Um 429 Too Many Requests significa que o cliente enviou muitas solicitações em pouco tempo e está sendo limitado pela taxa A resposta geralmente inclui um cabeçalho Retry-After informando ao cliente quanto tempo esperar antes de tentar novamente, e clientes bem comportados honram com um backoff exponencial.
A referência do código de status HTTP é gratuita para uso?
Sim. a ferramenta é totalmente gratuita sem inscrição e sem limites, e funciona offline uma vez que a página tenha carregado porque toda a lista é executada no seu navegador Nada do que você pesquisa é enviado para um servidor, por isso é seguro e rápido de usar durante a depuração.
