Referência técnica

Códigos de status de resposta HTTP

Os códigos de status HTTP são sinais de três dígitos em uma resposta de servidor. Seu primeiro dígito identifica o resultado geral; os dígitos restantes identificam uma condição específica. Este guia explica os códigos padrão registrados com contexto prático, além de valores notáveis específicos de provedores que podem aparecer em logs.

Como ler este catálogo: Um status não é um diagnóstico completo por si só. Verifique o método de solicitação, os cabeçalhos de resposta, o corpo, o destino de redirecionamento e o servidor ou proxy que o gerou. Valores não reconhecidos geralmente mantêm o significado de sua classe de primeiro dígito, mas seu comportamento exato pode ser específico da implementação.

Compatibilidade de navegadores e tratamento de respostas

Os códigos de status HTTP fazem parte do protocolo HTTP, não de um recurso de navegador que cada fornecedor implementa como uma API web separada. Os navegadores atuais conseguem lidar com as classes de resposta padrão; páginas de erro visíveis e comportamento de nova tentativa são específicos do navegador. O suporte a novas respostas provisórias e extensões especializadas pode diferir por versão e caminho de rede.

Família de respostasChrome / EdgeFirefoxSafariOperaWebView Android / iOSNota de compatibilidade
1xx informativoSuportado como respostas provisórias de protocoloSuportado como respostas provisórias de protocoloSuportado como respostas provisórias de protocoloSuportado como respostas provisórias de protocoloSuportado pela pilha de rede subjacente100/101 estão estabelecidos; 102 é de nicho/obsoleto. A adoção de 103 Early Hints e o comportamento observável de pré-carregamento variam conforme a versão do navegador, o servidor e o intermediário.
2xx sucessoSuportadoSuportadoSuportadoSuportadoSuportadoA semântica de sucesso padrão é compartilhada. As regras de corpo ainda importam: por exemplo, 204 e 205 não têm corpo de resposta.
3xx redirecionamentoSuportadoSuportadoSuportadoSuportadoSuportadoLocalização, método, cache e política de segurança afetam a navegação. 301/302 podem alterar POST para GET; 307/308 preservam o método.
4xx erro do cliente/solicitaçãoSuportadoSuportadoSuportadoSuportadoSuportadoO navegador recebe a resposta; se ele exibe o corpo do servidor ou uma visualização de erro gerada pelo navegador difere por status e produto.
5xx erro do servidorSuportadoSuportadoSuportadoSuportadoSuportadoOs clientes podem processar a classe de resposta, mas as páginas geradas por proxy, o comportamento de nova tentativa e a interface de diagnóstico não são idênticos em todos os navegadores.
Código desconhecido em uma classe conhecidaTratamento em nível de classeTratamento em nível de classeTratamento em nível de classeTratamento em nível de classeTratamento em nível de classeOs clientes HTTP podem deduzir a classe geral a partir do primeiro dígito; não confie em um código personalizado ter semântica padrão ou interface idêntica.

A compatibilidade aqui descreve o tratamento em nível de protocolo, e não uma garantia de que todos os navegadores exibem a mesma página de erro. Clientes mais antigos, WebViews embutidas, proxies e portais cativos podem impor comportamento adicional.

1xx — Respostas informativas

100

Continuar

O servidor aceitou os cabeçalhos da solicitação e está aguardando o restante do corpo da solicitação. É comumente usado com Expect: 100-continue para que um cliente possa evitar o upload de um corpo grande quando a solicitação for rejeitada.

Orientação operacional: Resposta provisória; continue enviando o corpo somente quando for esperado.

101

Mudando protocolos

O servidor concorda em alterar o protocolo para esta conexão após o cliente solicitar uma atualização. Os handshakes de WebSocket são um uso familiar.

Orientação operacional: Transição de nível Connection; verifique os cabeçalhos Upgrade e Connection.

102

Processando

Um servidor WebDAV relata que uma operação demorada foi iniciada, mas não foi concluída. É uma resposta legada/obsoleta e não deve ser confundida com o resultado final.

Orientação operacional: Status WebDAV provisório; aguarde a resposta final.

103

Dicas precoces (Early Hints)

O servidor envia cabeçalhos preliminares, frequentemente dicas Link, enquanto prepara a resposta final. Um cliente pode começar a buscar ativos criticamente prováveis mais cedo.

Orientação operacional: Otimização provisória; uma resposta final deve seguir-se.

2xx — Respostas bem-sucedidas

200

OK

A solicitação foi bem-sucedida. A representação depende do método: GET retorna o recurso, HEAD retorna metadados sem um corpo, e uma ação de gravação pode retornar uma representação de resultado.

Orientação operacional: Use para uma solicitação concluída com uma representação de resposta quando apropriado.

201

Criado

A solicitação foi concluída e criou um ou mais recursos. A resposta deve identificar o novo recurso, comumente com Location, e pode retornar sua representação.

Orientação operacional: Típico após POST ou PUT; garantir que o recurso criado possa ser localizado.

202

Aceito

O servidor aceitou a solicitação para processamento, mas o processamento não terminou e ainda pode falhar. O HTTP não entrega posteriormente uma segunda resposta para o mesmo intercâmbio.

Orientação operacional: Forneça uma operação/status URL ou outra maneira de saber o resultado final.

203

Informação não autoritativa

Um proxy de transformação ou intermediário retornou metadados ou conteúdo que difere da resposta de origem. Isso sinaliza que a resposta não é uma representação autoritativa direta.

Orientação operacional: Use somente quando uma transformação intermediária for relevante.

204

Sem conteúdo

A solicitação foi bem-sucedida e não há conteúdo de resposta para enviar. Os cabeçalhos ainda podem carregar metadados úteis, como validadores atualizados.

Orientação operacional: Não inclua um corpo na resposta.

205

Redefinir conteúdo

A solicitação foi bem-sucedida e o cliente é instruído a redefinir a visualização ou o formulário que a enviou. Nenhum conteúdo de resposta é enviado.

Orientação operacional: Útil para interações que devem limpar/redefinir o estado de entrada atual.

206

Conteúdo parcial

O servidor atendeu a uma solicitação de intervalo válida e retorna apenas o intervalo ou intervalos de bytes solicitados. Content-Range descreve o que foi entregue.

Orientação operacional: Certifique-se de que os valores range e Content-Range correspondam; comum para mídia/downloads recuperáveis.

207

Multi-status

Uma resposta WebDAV relata resultados separados para múltiplos recursos ou suboperações, geralmente em um corpo XML estruturado.

Orientação operacional: Interpretar cada resultado de recurso incorporado; o status externo por si só não é o resultado completo.

208

Já relatado

Uma resposta multistatus do WebDAV omite membros já listados anteriormente na mesma resposta para evitar repeti-los.

Orientação operacional: Específico para WebDAV; interpretar junto com a resposta multistatus circundante.

226

IM Usado

O servidor atendeu a um GET usando manipulações de instância e retorna uma representação derivada do recurso atual de acordo com o mecanismo de delta negociado.

Orientação operacional: Codificação delta especializada; clientes e servidores devem concordar com a transformação.

3xx — Redirecionamento e validação de cache

300

Múltiplas escolhas

O destino possui múltiplas representações ou destinos e a resposta oferece escolhas. Um cliente ou usuário pode selecionar a variante preferida.

Orientação operacional: Incluir alternativas claras; não presuma que cada cliente escolherá automaticamente.

301

Movido permanentemente

O recurso possui um novo URI duradouro. Os clientes podem atualizar links e caches armazenados, portanto, use-o apenas quando a mudança for planejada para persistir.

Orientação operacional: Para migrações SEO, redirecione diretamente para o URL equivalente final e atualize os links internos.

302

Encontrado

O recurso está temporariamente disponível em outro URI. O comportamento histórico permite alterações de método em alguns casos, portanto, não é a escolha mais segura quando um POST deve permanecer um POST.

Orientação operacional: Use para movimentos temporários quando a reescrita de método for aceitável; considere 307 quando não é.

303

Ver outro

O cliente deve recuperar o recurso nomeado por Location com GET (ou HEAD conforme apropriado), em vez de repetir a ação original. É comumente usado após o envio de um formulário.

Orientação operacional: Implementa o padrão Post/Redirect/Get e evita o reenvio da ação.

304

Não modificado

Um GET ou HEAD condicional indica que a representação em cache ainda está atualizada. A resposta não tem corpo e permite que o cliente reutilize sua cópia armazenada.

Orientação operacional: Retorne somente quando um validador como If-None-Match ou If-Modified-Since corresponder.

305

Usar proxy

Uma resposta histórica propôs que o cliente acessasse o recurso através de um proxy. Está obsoleta por motivos de segurança e não deve ser usada por serviços modernos.

Orientação operacional: Não implante; configurar proxies fora da banda.

306

Não utilizado

Este valor é reservado/não utilizado nas especificações HTTP modernas. Não possui significado operacional padrão para uma aplicação web atual.

Orientação operacional: Não o envie.

307

Redirecionamento temporário

O recurso está temporariamente em outro URI, e o cliente deve preservar o método e o corpo originais ao seguir o redirecionamento.

Orientação operacional: Use quando a realocação temporária não deve transformar POST em GET.

308

Redirecionamento permanente

O recurso foi movido permanentemente, e o cliente deve preservar o método e o corpo originais ao seguir o redirecionamento.

Orientação operacional: Use para movimentos duradouros onde a preservação do método é importante; atualizar referências canônicas/internas.

4xx — Erros do cliente/solicitação

400

Solicitação incorreta

O servidor não pode processar a solicitação porque sua sintaxe, enquadramento ou dados fornecidos são inválidos. Repetir a mesma solicitação inalterada provavelmente não ajudará.

Orientação operacional: Inspecione a codificação URL, a sintaxe JSON/corpo, os campos obrigatórios e o enquadramento da solicitação.

401

Não autorizado

A solicitação carece de credenciais de autenticação válidas para o destino. Apesar do nome, esta resposta significa que a autenticação é necessária ou falhou.

Orientação operacional: Envie as credenciais esperadas e inclua um desafio WWW-Authenticate.

402

Pagamento obrigatório

Reservado para uso futuro, embora alguns produtos o usem para fluxos de trabalho de pagamento ou cota. Não existe um comportamento de pagamento universalmente interoperável único.

Orientação operacional: Trate os significados específicos do fornecedor como tal; documentar o contrato API.

403

Proibido

O servidor entendeu a solicitação, mas recusa-se a cumpri-la. Credenciais válidas não alteram necessariamente o resultado porque a restrição pode ser baseada em políticas.

Orientação operacional: Verifique permissões, política de acesso, regras IP/WAF e autorização em nível de recurso.

404

Não encontrado

O servidor não consegue encontrar uma representação atual para o URI solicitado, ou não está disposto a divulgar que uma existe. A resposta por si só não diz se a ausência é temporária ou permanente.

Orientação operacional: Repare o URL, restaure o recurso ou use 410 quando a remoção for considerada permanente.

405

Método não permitido

O recurso existe, mas não suporta o método usado nesta solicitação.

Orientação operacional: Retorne um cabeçalho Allow listando os métodos que o recurso aceita.

406

Não aceitável

O servidor não pode produzir uma representação correspondente às preferências proativas de Accept do cliente.

Orientação operacional: Relaxe as restrições de Accept ou configure uma política adequada de representação e negociação.

407

Autenticação de proxy necessária

Um proxy intermediário requer credenciais antes de encaminhar a solicitação.

Orientação operacional: Autentique no proxy usando Proxy-Authenticate/Proxy-Authorization; isso é diferente da autenticação de origem.

408

Tempo limite da solicitação (Request Timeout)

O servidor não recebeu a solicitação completa no tempo em que estava preparado para esperar. O cliente pode tentar novamente em uma nova conexão.

Orientação operacional: Verifique as paralisações da rede, o tamanho do upload e as configurações de tempo limite do servidor/proxy.

409

Conflito

A solicitação entra em conflito com o estado atual do recurso, como uma colisão de versão ou uma tentativa de criar um duplicado.

Orientação operacional: Explique o conflito e forneça o estado atual suficiente para que o cliente o resolva.

410

Removido (Gone)

O recurso está intencionalmente e provavelmente permanentemente indisponível, sem substituição conhecida. Isso é mais forte do que uma resposta genérica de não encontrado.

Orientação operacional: Use quando a remoção for deliberada; remova links e referências internas obsoletas.

411

Comprimento necessário (Length Required)

O servidor requer um cabeçalho Content-Length, mas a solicitação não forneceu um.

Orientação operacional: Envie um Content-Length preciso ou use um enquadramento de transferência compatível.

412

Pré-condição falhou

Uma condição de solicitação, como If-Match, avaliada como falsa, portanto, o servidor não executou a ação solicitada.

Orientação operacional: Atualize a representação e tente novamente com os validadores/estado atuais.

413

Conteúdo muito grande

O corpo da solicitação excede um limite que o servidor está disposto ou apto a processar. O servidor pode fechar a conexão ou permitir nova tentativa após reduzir o corpo.

Orientação operacional: Reduza o tamanho do payload ou ajuste os limites de upload documentados.

414

URI muito longo

O destino da solicitação é mais longo do que o servidor está disposto a interpretar, frequentemente devido a uma string de consulta superdimensionada.

Orientação operacional: Use um URI mais curto ou mova dados adequados para um corpo de solicitação.

415

Tipo de mídia não suportado

O servidor recusa o corpo da solicitação porque seu tipo de mídia, codificação de conteúdo ou formato inspecionado não é suportado.

Orientação operacional: Envie uma codificação/Content-Type compatível e um corpo correspondente.

416

Intervalo não satisfatível (Range Not Satisfiable)

O intervalo de bytes solicitado não pode ser atendido, por exemplo, porque começa além do comprimento da representação.

Orientação operacional: Verifique novamente o comprimento do recurso e as unidades range; servidores podem retornar Content-Range: bytes */comprimento.

417

Expectativa falhou

O servidor ou intermediário não pode atender a uma expectativa declarada no cabeçalho Expect.

Orientação operacional: Tente novamente sem a expectativa infundada quando for seguro e apropriado.

418

Sou um bule de chá (I'm a teapot)

Um status humorístico originado em uma especificação de Dia da Mentira. Não é um contrato normal de erro de aplicativo, embora alguns serviços o usem de forma lúdica.

Orientação operacional: Não dependa dele para um comportamento de produção interoperável.

421

Solicitação mal direcionada

A solicitação atingiu um servidor que não pode produzir uma resposta autoritativa para o URI de destino, frequentemente porque o roteamento da conexão ou a autoridade HTTP não correspondem.

Orientação operacional: Tente novamente em um connection adequado e inspecione Host/:authority, SNI e roteamento de proxy.

422

Conteúdo não processável

O tipo de conteúdo e a sintaxe são compreendidos, mas o servidor não pode aplicar as instruções ou validar o conteúdo enviado.

Orientação operacional: Retornar detalhes de validação em nível de campo acionáveis; corrigir a carga útil pode ter sucesso no allow.

423

Bloqueado

Um recurso WebDAV está bloqueado, portanto, o método solicitado não pode ser executado até que a condição de bloqueio seja resolvida.

Orientação operacional: Verifique a propriedade do bloqueio, o tempo limite e o tratamento do token de bloqueio WebDAV.

424

Dependência com falha

Uma operação WebDAV falhou porque uma operação precedente necessária na mesma sequência de solicitações falhou.

Orientação operacional: Resolva a ação anterior com falha antes de tentar novamente as operações dependentes.

425

Muito cedo

O servidor recusa-se a processar uma solicitação que pode ter sido reproduzida durante dados iniciais (early data), para reduzir o risco de repetição.

Orientação operacional: Tente novamente depois que o connection for estabelecido sem dados iniciais.

426

Atualização necessária (Upgrade Required)

O servidor recusa o protocolo atual e indica que o cliente deve mudar para outro.

Orientação operacional: Inclua um cabeçalho Upgrade que descreva as opções de protocolo suportadas.

428

Pré-condição necessária

O servidor requer uma solicitação condicional para evitar atualizações perdidas, mas o cliente enviou uma incondicional.

Orientação operacional: Busque o estado atual e envie uma condição apropriada, como If-Match.

429

Muitas solicitações

O cliente enviou muitas solicitações em um determinado período, com base em um limite de taxa definido pelo servidor.

Orientação operacional: Recue, respeite Retry-After quando presente e evite rajadas de novas tentativas sincronizadas.

431

Campos de cabeçalho de solicitação muito grandes

O servidor não processará a solicitação porque um ou mais campos de cabeçalho, ou o conjunto de cabeçalhos combinados, são muito grandes.

Orientação operacional: Reduza os cookies ou cabeçalhos personalizados, ou ajuste um limite intencional do servidor.

451

Indisponível por motivos legais

O servidor não pode fornecer o recurso solicitado devido a uma restrição legal.

Orientação operacional: Se for caso disso, explique a restrição e o seu âmbito sem expor informações protegidas.

5xx — Erros de servidor e intermediários

500

Erro interno do servidor

O servidor encontrou uma condição inesperada e não pode concluir a solicitação. É um fallback geral quando nenhum erro de servidor mais preciso se aplica.

Orientação operacional: Correlacione a solicitação com os logs do servidor e evite expor rastreamentos de pilha aos visitantes.

501

Não implementado

O servidor não suporta a funcionalidade necessária para cumprir a solicitação, comumente um método ou capacidade não implementado.

Orientação operacional: Implemente o recurso ou use um método compatível; não se destina a sobrecarga temporária.

502

Bad Gateway (Gateway inválido)

Um servidor atuando como gateway ou proxy recebeu uma resposta inválida de um servidor upstream.

Orientação operacional: Inspecione a integridade upstream, configurações de protocolo/TLS, DNS e logs de proxy.

503

Serviço indisponível

O servidor está temporariamente incapaz de lidar com a solicitação, frequentemente devido a manutenção ou sobrecarga.

Orientação operacional: Se possível, forneça Retry-After, uma resposta útil e controles de cache adequados para uma falha temporária.

504

Tempo limite do gateway (Gateway Timeout)

Um gateway ou proxy não recebeu uma resposta em tempo hábil de um serviço upstream.

Orientação operacional: Investigue a latência upstream, os caminhos de rede e os orçamentos de tempo limite em toda a cadeia.

505

Versão HTTP não suportada

O servidor não suporta a versão principal do HTTP usada na solicitação.

Orientação operacional: Use uma versão de protocolo compatível ou atualize a configuração do servidor/proxy.

506

Variante também negocia

Um erro de configuração do servidor criou um arranjo circular de negociação de conteúdo no qual a variante selecionada negocia novamente.

Orientação operacional: Corrija a configuração da variante/negociação; esta é uma falha do lado da origem.

507

Armazenamento insuficiente

Um servidor WebDAV não pode armazenar a representação necessária para concluir a operação.

Orientação operacional: Libere ou provisione armazenamento e verifique as cotas antes de tentar novamente.

508

Loop detectado

Um servidor detectou um loop infinito ao processar uma solicitação, comumente durante a travessia de vinculação WebDAV.

Orientação operacional: Quebre o relacionamento de recursos cíclicos ou a regra de processamento.

510

Não estendido

A solicitação requer uma extensão que o servidor não suporta.

Orientação operacional: Use um conjunto de extensões compatível ou negocie uma alternativa.

511

Autenticação de rede necessária

O cliente deve se autenticar para obter acesso à rede, normalmente em um portal cativo. Destina-se a intermediários de rede, não a um login de site de origem.

Orientação operacional: Conclua a autenticação de acesso à rede e tente novamente a solicitação original.

Respostas notáveis não padrão e específicas de provedores

Estes valores são vistos em produtos específicos, logs de servidores, CDNs ou aplicações. Eles não são intercambiáveis com significados padrão registrados; consulte o contrato do serviço gerador.

419

Tempo limite de autenticação (não padrão)

Alguns aplicativos usam este rótulo quando uma sessão de autenticação expira. Não é um status HTTP atribuído universalmente, portanto, os clientes não podem confiar em semântica consistente.

Orientação operacional: Atualize a autenticação de acordo com o contrato de serviço.

420

Melhore sua calma (não padrão)

Uma resposta específica do fornecedor usada historicamente para limitação de taxa (throttling). Seu significado é definido pela implementação.

Orientação operacional: Siga as orientações documentadas sobre limites de solicitações.

444

Conexão fechada (não padrão)

Alguns servidores fecham a conexão sem enviar uma resposta convencional, frequentemente como uma medida de filtragem.

Orientação operacional: Verifique os registros do provedor; os clientes podem relatar um erro de rede em vez de exibir esse código.

449

Tentar novamente com (não padrão)

Uma extensão da Microsoft usada por alguns serviços para pedir a um cliente que tente novamente com informações adicionais.

Orientação operacional: Siga a documentação específica da API.

499

Cliente fechou a solicitação (não padrão)

Um proxy reverso pode registrar isso quando o cliente se desconecta antes que a resposta do upstream seja concluída. Geralmente é uma classificação de log em vez de uma resposta entregue a esse cliente.

Orientação operacional: Investigue cancelamentos de clientes e retarde solicitações upstream.

509

Limite de largura de banda excedido (não padrão)

Algumas plataformas de hospedagem usam este código para uma cota ou limite de largura de banda. Não é um significado HTTP interoperável geral.

Orientação operacional: Verifique a cota e a configuração de faturamento do host.

520

O servidor web retornou um erro desconhecido (específico do fornecedor)

Uma CDN ou proxy pode usar isso quando recebe uma resposta de origem inesperada ou vazia.

Orientação operacional: Compare edge e logs de origem; verifique se a origem emite uma resposta HTTP válida.

521

O servidor web está inativo (específico do fornecedor)

Um proxy não pôde estabelecer uma conexão com a origem ou a origem a recusou.

Orientação operacional: Verifique a disponibilidade de origem, regras de firewall e listas de permissões de proxy.

522

Conexão expirada (específico do fornecedor)

Um serviço de borda conectou-se ou tentou conectar-se à origem, mas não concluiu o intercâmbio dentro do seu tempo limite.

Orientação operacional: Revise a capacidade de resposta da origem e a latência da rede.

523

A origem está inacessível (específico do fornecedor)

Um proxy não pôde alcançar o endereço de origem configurado.

Orientação operacional: Verifique a resolução, o roteamento e a configuração de origem do DNS IP.

524

Ocorreu um tempo limite (específico do fornecedor)

A conexão com a origem foi bem-sucedida, mas a origem não enviou uma resposta HTTP em tempo hábil.

Orientação operacional: Reduza o tempo de processamento do servidor de origem ou ajuste os tempos limite compatíveis.

525

Falha no handshake SSL (específico do fornecedor)

Um proxy não pôde concluir a negociação TLS com a origem.

Orientação operacional: Valide certificados, compatibilidade de protocolo/cifra e SNI.

526

Certificado SSL inválido (específico do fornecedor)

Um intermediário rejeitou o certificado de origem durante a validação.

Orientação operacional: Instale um certificado válido, nomeado corretamente, confiável e não expirado e uma cadeia completa.

527

Erro Railgun (específico do fornecedor)

Um status de proxy legado/específico do fornecedor relata uma falha em uma conexão de aceleração de origem.

Orientação operacional: Inspecione o conector específico do provedor e o caminho de origem.

598

Tempo limite de leitura de rede (não padrão)

Alguns clientes ou proxies usam este valor para descrever um tempo limite de leitura de rede. Não tem significado HTTP universal.

Orientação operacional: Consulte os diagnósticos do cliente ou do proxy.

599

Tempo limite de conexão de rede (não padrão)

Alguns proxies usam este valor quando uma tentativa de conexão de rede atinge o tempo limite. Seu significado depende da implementação.

Orientação operacional: Verifique a conectividade e os tempos limite.

Uso de códigos de status em redirecionamentos e auditorias de SEO

Para uma mudança permanente de URL, use um redirecionamento permanente apenas quando o destino se destina a substituir o URL antigo; para uma alteração temporária, selecione uma resposta temporária. Mantenha as correntes curtas e aponte para o destino equivalente final. Confirme se cada valor de Location é resolvido, se a resposta final é apropriada e se as tags canônicas e os links internos concordam com o URL pretendido. Um 2xx no final confirma uma resposta de sucesso HTTP, não que a página seja útil, indexável ou tecnicamente saudável.

Fontes e notas de referência

Esta página resume o significado dos códigos de status HTTP para uso prático. O registro de padrões e os RFCs são as fontes oficiais para códigos padronizados; o MDN oferece um guia técnico acessível, e a Wikipédia é uma visão complementar mantida pela comunidade.