HTTP Status Codes

Consulte o significado dos códigos de status HTTP: pesquise por número ou descrição e veja explicação, exemplo e quando cada um aparece.

Pesquisar código ou descrição

Mais consultados

61 códigos

1xx — Informativos

Respostas provisórias: a requisição foi recebida e o processamento continua. O cliente normalmente as trata sozinho.

100Continue · Continuar

O servidor recebeu os cabeçalhos; o cliente pode enviar o corpo.

Código: 100 — Continue
Categoria: Informativo (1xx)
Explicação: Resposta provisória usada com o cabeçalho Expect: 100-continue. O cliente manda primeiro os cabeçalhos e só envia o corpo (por exemplo, um arquivo grande) depois de receber o 100.
Exemplo de uso: Um cliente vai enviar um upload grande e quer saber se o servidor aceita antes de transmitir o corpo.
Quando aparece: Uploads grandes com Expect: 100-continue. Bibliotecas e navegadores costumam tratá-lo sem que você perceba.
Referência: RFC 9110, seção 15.2.1

Link direto para o 100

101Switching Protocols · Mudando de protocolo

O servidor aceitou trocar o protocolo da conexão.

Código: 101 — Switching Protocols
Categoria: Informativo (1xx)
Explicação: Resposta ao cabeçalho Upgrade: o servidor concorda em passar a falar outro protocolo na mesma conexão.
Exemplo de uso: Ao abrir um WebSocket, o cliente pede Upgrade: websocket e o servidor responde 101.
Quando aparece: No handshake de WebSockets e em upgrades de protocolo.
Referência: RFC 9110, seção 15.2.2

Link direto para o 101

102Processing · Processando

O servidor recebeu a requisição e ainda está processando.

Código: 102 — Processing
Categoria: Informativo (1xx)
Explicação: Código do WebDAV usado para evitar que o cliente desista em operações demoradas. Ainda aparece no registro IANA, mas é pouco usado hoje.
Exemplo de uso: Uma operação WebDAV demorada, como copiar uma pasta muito grande.
Quando aparece: Raro; aparece em servidores WebDAV.
Referência: RFC 2518 (WebDAV)

Link direto para o 102

103Early Hints · Dicas antecipadas

O servidor envia cabeçalhos preliminares antes da resposta final.

Código: 103 — Early Hints
Categoria: Informativo (1xx)
Explicação: Permite que o navegador comece a carregar recursos (como CSS e JavaScript) enquanto o servidor ainda prepara a resposta final.
Exemplo de uso: O servidor manda Link: </estilo.css>; rel=preload antes de terminar de montar o HTML.
Quando aparece: Otimização de desempenho em servidores e CDNs modernos.
Referência: RFC 8297

Link direto para o 103

2xx — Sucesso

A requisição foi recebida, entendida e aceita com sucesso.

200OK · OK

A requisição foi bem-sucedida.

Código: 200 — OK
Categoria: Sucesso (2xx)
Explicação: O significado depende do método: em GET, o corpo traz o recurso pedido; em POST, o resultado da ação executada.
Exemplo de uso: Abrir uma página ou consultar uma API que devolve os dados solicitados.
Quando aparece: É a resposta mais comum da web.
Referência: RFC 9110, seção 15.3.1

Link direto para o 200

201Created · Criado

A requisição teve sucesso e criou um novo recurso.

Código: 201 — Created
Categoria: Sucesso (2xx)
Explicação: Normalmente acompanha o cabeçalho Location, que aponta para o recurso criado.
Exemplo de uso: POST /usuarios cria um usuário e devolve 201 com Location: /usuarios/42.
Quando aparece: Em APIs REST, depois de criar um recurso.
Referência: RFC 9110, seção 15.3.2

Link direto para o 201

202Accepted · Aceito

A requisição foi aceita, mas ainda não foi concluída.

Código: 202 — Accepted
Categoria: Sucesso (2xx)
Explicação: O processamento é assíncrono: o resultado final pode ainda não estar pronto.
Exemplo de uso: Um pedido de geração de relatório entra em uma fila e a API responde 202.
Quando aparece: Tarefas assíncronas, filas e processamentos em segundo plano.
Referência: RFC 9110, seção 15.3.3

Link direto para o 202

203Non-Authoritative Information · Informação não autoritativa

A resposta é um 200 modificado por um proxy intermediário.

Código: 203 — Non-Authoritative Information
Categoria: Sucesso (2xx)
Explicação: Indica que o conteúdo recebido pode ser diferente do que o servidor de origem enviou, porque um intermediário o transformou.
Exemplo de uso: Um proxy que altera cabeçalhos da resposta de origem e informa isso com 203.
Quando aparece: Raro; ligado a proxies que modificam respostas.
Referência: RFC 9110, seção 15.3.4

Link direto para o 203

204No Content · Sem conteúdo

Sucesso, sem corpo na resposta.

Código: 204 — No Content
Categoria: Sucesso (2xx)
Explicação: A ação deu certo e não há nada para devolver. O cliente normalmente mantém a visão em que estava.
Exemplo de uso: DELETE /itens/7 remove o item e responde 204; um PUT que salva sem devolver dados.
Quando aparece: Exclusões e atualizações em APIs.
Referência: RFC 9110, seção 15.3.5

Link direto para o 204

205Reset Content · Redefinir conteúdo

Sucesso; o cliente deve redefinir a visão do documento.

Código: 205 — Reset Content
Categoria: Sucesso (2xx)
Explicação: Pede que o cliente volte a visão que originou a requisição ao estado inicial, por exemplo limpando um formulário. Não traz corpo.
Exemplo de uso: Depois de enviar uma linha em um formulário de entrada de dados, o servidor pede para limpá-lo.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.3.6

Link direto para o 205

206Partial Content · Conteúdo parcial

O servidor entregou apenas uma parte do recurso.

Código: 206 — Partial Content
Categoria: Sucesso (2xx)
Explicação: Resposta a uma requisição com o cabeçalho Range. É a base de downloads retomáveis e de streaming de vídeo e áudio.
Exemplo de uso: Um player pede bytes=0-1023 de um vídeo e recebe 206 com Content-Range.
Quando aparece: Streaming, downloads em partes e retomada de downloads.
Referência: RFC 9110, seção 15.3.7

Link direto para o 206

207Multi-Status · Múltiplos status

O corpo traz vários status, um para cada recurso afetado.

Código: 207 — Multi-Status
Categoria: Sucesso (2xx)
Explicação: Usado no WebDAV quando uma operação em lote tem resultados diferentes por item. O corpo (XML) detalha cada um.
Exemplo de uso: Apagar vários arquivos de uma vez: alguns são removidos e um é negado.
Quando aparece: Servidores WebDAV.
Referência: RFC 4918 (WebDAV)

Link direto para o 207

208Already Reported · Já informado

Os membros da coleção já foram listados antes na mesma resposta.

Código: 208 — Already Reported
Categoria: Sucesso (2xx)
Explicação: Usado no WebDAV, dentro de uma resposta 207, para não repetir membros de uma coleção que aparecem mais de uma vez.
Exemplo de uso: Uma coleção que contém o mesmo recurso por dois caminhos diferentes.
Quando aparece: Raro; servidores WebDAV com vínculos (bindings).
Referência: RFC 5842 (WebDAV)

Link direto para o 208

226IM Used · IM utilizado

O servidor devolveu o resultado de manipulações aplicadas ao recurso.

Código: 226 — IM Used
Categoria: Sucesso (2xx)
Explicação: Relacionado ao delta encoding em HTTP: o servidor entrega só a diferença em relação a uma versão que o cliente já tem.
Exemplo de uso: Um cliente pede apenas as mudanças desde a última versão baixada de um feed.
Quando aparece: Muito raro.
Referência: RFC 3229

Link direto para o 226

3xx — Redirecionamento

O cliente precisa tomar outra ação, em geral seguir para outro endereço, para concluir a requisição.

300Multiple Choices · Múltiplas escolhas

Há mais de uma representação possível do recurso.

Código: 300 — Multiple Choices
Categoria: Redirecionamento (3xx)
Explicação: O servidor indica várias opções de endereço ou formato e o cliente (ou o usuário) deve escolher uma. Na prática é raro.
Exemplo de uso: Um recurso disponível em vários formatos ou idiomas sem negociação automática.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.4.1

Link direto para o 300

301Moved Permanently · Movido permanentemente

O recurso mudou de endereço de forma permanente.

Código: 301 — Moved Permanently
Categoria: Redirecionamento (3xx)
Explicação: O cabeçalho Location traz a nova URL. Navegadores e buscadores atualizam seus registros. Alguns clientes trocam POST por GET; para preservar o método, use 308.
Exemplo de uso: Migração de http para https ou mudança de domínio de um site.
Quando aparece: Redirecionamentos de SEO e migrações de endereço.
Referência: RFC 9110, seção 15.4.2

Link direto para o 301

302Found · Encontrado

Redirecionamento temporário para outra URL.

Código: 302 — Found
Categoria: Redirecionamento (3xx)
Explicação: O recurso está temporariamente em outro endereço e o endereço original deve continuar sendo usado. Muitos clientes trocam POST por GET; para preservar o método, use 307.
Exemplo de uso: Redirecionar para a página de login e depois voltar à página original.
Quando aparece: Login, promoções temporárias e testes A/B.
Referência: RFC 9110, seção 15.4.3

Link direto para o 302

303See Other · Veja outro

O resultado está em outra URL e deve ser obtido com GET.

Código: 303 — See Other
Categoria: Redirecionamento (3xx)
Explicação: Usado no padrão Post/Redirect/Get: depois de processar um POST, o servidor redireciona o cliente para uma página que ele busca com GET, evitando reenvio do formulário ao recarregar.
Exemplo de uso: Após enviar um formulário, o servidor redireciona para a página de confirmação com 303.
Quando aparece: Logo depois de um POST bem-sucedido.
Referência: RFC 9110, seção 15.4.4

Link direto para o 303

304Not Modified · Não modificado

O recurso não mudou desde a versão que o cliente já tem em cache.

Código: 304 — Not Modified
Categoria: Redirecionamento (3xx)
Explicação: Resposta a requisições condicionais (If-None-Match, If-Modified-Since). Não traz corpo: o cliente reaproveita a cópia em cache.
Exemplo de uso: O navegador reenvia o ETag de um arquivo e recebe 304 em vez de baixá-lo de novo.
Quando aparece: Cache de navegador e de CDN.
Referência: RFC 9110, seção 15.4.5

Link direto para o 304

305Use Proxy · Use proxy

Obsoleto: indicava que o recurso só podia ser acessado por um proxy.

Código: 305 — Use Proxy
Categoria: Redirecionamento (3xx)
Explicação: Foi descontinuado por razões de segurança e não deve ser usado nem tratado pelos clientes.
Exemplo de uso: Não há uso atual.
Quando aparece: Obsoleto.
Referência: RFC 9110, seção 15.4.6 (descontinuado)

Link direto para o 305

307Temporary Redirect · Redirecionamento temporário

Redirecionamento temporário que mantém o método e o corpo.

Código: 307 — Temporary Redirect
Categoria: Redirecionamento (3xx)
Explicação: Como o 302, mas o cliente deve repetir a requisição com o mesmo método e corpo no novo endereço (um POST continua sendo POST).
Exemplo de uso: Uma API redireciona temporariamente uma requisição POST para outro servidor.
Quando aparece: APIs e redirecionamentos HTTP -> HTTPS que precisam preservar o método.
Referência: RFC 9110, seção 15.4.8

Link direto para o 307

308Permanent Redirect · Redirecionamento permanente

Redirecionamento permanente que mantém o método e o corpo.

Código: 308 — Permanent Redirect
Categoria: Redirecionamento (3xx)
Explicação: Como o 301, mas o cliente deve repetir a requisição com o mesmo método e corpo no novo endereço.
Exemplo de uso: Uma API mudou de endereço de forma definitiva e as requisições POST devem continuar funcionando.
Quando aparece: Migrações permanentes de APIs.
Referência: RFC 9110, seção 15.4.9

Link direto para o 308

4xx — Erros do cliente

A requisição tem algum problema (sintaxe, permissão, recurso inexistente...). A correção costuma estar no lado de quem pede.

400Bad Request · Requisição inválida

O servidor não entendeu a requisição por erro do cliente.

Código: 400 — Bad Request
Categoria: Erro do cliente (4xx)
Explicação: A requisição está malformada: sintaxe inválida, cabeçalhos errados ou parâmetros que o servidor não consegue interpretar.
Exemplo de uso: Enviar um JSON com vírgula sobrando para uma API.
Quando aparece: Corpo ou parâmetros inválidos em formulários e APIs.
Referência: RFC 9110, seção 15.5.1

Link direto para o 400

401Unauthorized · Não autorizado

A requisição exige autenticação válida, que falta ou está incorreta.

Código: 401 — Unauthorized
Categoria: Erro do cliente (4xx)
Explicação: Apesar do nome, trata de autenticação (quem é você?). Costuma vir com o cabeçalho WWW-Authenticate indicando como se autenticar.
Exemplo de uso: Chamar uma API sem token, ou com um token expirado.
Quando aparece: Login ausente, senha errada ou token inválido.
Referência: RFC 9110, seção 15.5.2

Link direto para o 401

402Payment Required · Pagamento necessário

Reservado para uso futuro com pagamentos digitais.

Código: 402 — Payment Required
Categoria: Erro do cliente (4xx)
Explicação: Não tem uso padronizado. Algumas APIs o usam, por conta própria, para indicar plano vencido ou cota paga esgotada.
Exemplo de uso: Uma API responde 402 porque a assinatura expirou.
Quando aparece: Raro; uso específico de cada serviço.
Referência: RFC 9110, seção 15.5.3

Link direto para o 402

403Forbidden · Proibido

O servidor entendeu a requisição, mas se recusa a atendê-la.

Código: 403 — Forbidden
Categoria: Erro do cliente (4xx)
Explicação: Diferente do 401: autenticar de novo não resolve, porque o problema é a falta de permissão. Pode também ocultar o motivo da recusa.
Exemplo de uso: Um usuário logado tentando abrir uma área exclusiva de administradores.
Quando aparece: Falta de permissão, bloqueio por IP ou regra de firewall.
Referência: RFC 9110, seção 15.5.4

Link direto para o 403

404Not Found · Não encontrado

O servidor não encontrou o recurso solicitado.

Código: 404 — Not Found
Categoria: Erro do cliente (4xx)
Explicação: O endereço não existe (ou não existe mais). Servidores também usam o 404 para ocultar a existência de um recurso privado.
Exemplo de uso: Digitar uma URL errada ou abrir um link para uma página removida.
Quando aparece: Links quebrados, URLs digitadas errado e páginas removidas.
Referência: RFC 9110, seção 15.5.5

Link direto para o 404

405Method Not Allowed · Método não permitido

O método HTTP não é aceito para esse recurso.

Código: 405 — Method Not Allowed
Categoria: Erro do cliente (4xx)
Explicação: O recurso existe, mas não aceita aquele método. O servidor deve enviar o cabeçalho Allow com os métodos permitidos.
Exemplo de uso: Fazer um POST em um endpoint que só aceita GET.
Quando aparece: Uso do método errado em uma API.
Referência: RFC 9110, seção 15.5.6

Link direto para o 405

406Not Acceptable · Não aceitável

O servidor não consegue gerar uma resposta compatível com o que o cliente aceita.

Código: 406 — Not Acceptable
Categoria: Erro do cliente (4xx)
Explicação: A negociação de conteúdo falhou: nenhuma representação do recurso atende aos cabeçalhos Accept, Accept-Language ou similares.
Exemplo de uso: Pedir Accept: application/xml a uma API que só oferece JSON.
Quando aparece: Negociação de conteúdo em APIs.
Referência: RFC 9110, seção 15.5.7

Link direto para o 406

407Proxy Authentication Required · Autenticação de proxy necessária

Como o 401, mas a autenticação é exigida pelo proxy.

Código: 407 — Proxy Authentication Required
Categoria: Erro do cliente (4xx)
Explicação: O cliente precisa se autenticar no proxy antes de a requisição seguir adiante. A resposta traz o cabeçalho Proxy-Authenticate.
Exemplo de uso: Uma rede corporativa cujo proxy pede usuário e senha.
Quando aparece: Redes com proxy autenticado.
Referência: RFC 9110, seção 15.5.8

Link direto para o 407

408Request Timeout · Tempo da requisição esgotado

O cliente demorou demais para enviar a requisição completa.

Código: 408 — Request Timeout
Categoria: Erro do cliente (4xx)
Explicação: O servidor encerrou a espera por uma requisição que não chegou inteira no tempo limite. O cliente pode tentar de novo.
Exemplo de uso: Uma conexão lenta ou ociosa que não termina de enviar o corpo.
Quando aparece: Conexões instáveis ou muito lentas.
Referência: RFC 9110, seção 15.5.9

Link direto para o 408

409Conflict · Conflito

A requisição conflita com o estado atual do recurso.

Código: 409 — Conflict
Categoria: Erro do cliente (4xx)
Explicação: A operação não pode ser concluída por causa de um conflito, como edição concorrente ou valor duplicado. O corpo deve explicar o conflito.
Exemplo de uso: Cadastrar um usuário com um e-mail que já existe, ou salvar uma versão desatualizada.
Quando aparece: Duplicidade e edições simultâneas.
Referência: RFC 9110, seção 15.5.10

Link direto para o 409

410Gone · Desaparecido

O recurso foi removido de forma intencional e permanente.

Código: 410 — Gone
Categoria: Erro do cliente (4xx)
Explicação: Mais explícito que o 404: o recurso existiu, não existe mais e não há novo endereço. Buscadores tendem a removê-lo do índice mais rápido.
Exemplo de uso: Uma página de promoção encerrada e retirada de vez do site.
Quando aparece: Conteúdo removido definitivamente.
Referência: RFC 9110, seção 15.5.11

Link direto para o 410

411Length Required · Comprimento necessário

O servidor exige o cabeçalho Content-Length.

Código: 411 — Length Required
Categoria: Erro do cliente (4xx)
Explicação: A requisição tem corpo, mas não informou o tamanho dele e o servidor não aceita assim.
Exemplo de uso: Enviar um POST sem Content-Length para um servidor que o exige.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.5.12

Link direto para o 411

412Precondition Failed · Pré-condição falhou

Uma condição dos cabeçalhos da requisição não foi satisfeita.

Código: 412 — Precondition Failed
Categoria: Erro do cliente (4xx)
Explicação: Cabeçalhos como If-Match e If-Unmodified-Since impõem condições. Se o recurso não as cumpre, o servidor não executa a operação. Útil para controle de concorrência.
Exemplo de uso: Atualizar um recurso com If-Match usando um ETag desatualizado.
Quando aparece: Atualizações condicionais em APIs.
Referência: RFC 9110, seção 15.5.13

Link direto para o 412

413Content Too Large · Conteúdo grande demais

O corpo da requisição é maior do que o servidor aceita.

Código: 413 — Content Too Large
Categoria: Erro do cliente (4xx)
Explicação: O servidor recusa processar porque o corpo excede o limite configurado. Antes da RFC 9110 o nome era Payload Too Large (e, antes, Request Entity Too Large).
Exemplo de uso: Enviar um arquivo de 200 MB para um upload limitado a 10 MB.
Quando aparece: Uploads acima do limite do servidor ou do proxy.
Referência: RFC 9110, seção 15.5.14

Link direto para o 413

414URI Too Long · URI muito longa

A URL é mais longa do que o servidor aceita.

Código: 414 — URI Too Long
Categoria: Erro do cliente (4xx)
Explicação: O servidor se recusa a processar porque o endereço, incluindo a query string, passou do limite. Antes da RFC 9110 o nome era Request-URI Too Long.
Exemplo de uso: Um GET com uma query string gigantesca; nesses casos, prefira enviar os dados no corpo de um POST.
Quando aparece: GETs com muitos parâmetros ou dados embutidos na URL.
Referência: RFC 9110, seção 15.5.15

Link direto para o 414

415Unsupported Media Type · Tipo de mídia não suportado

O formato do corpo da requisição não é aceito.

Código: 415 — Unsupported Media Type
Categoria: Erro do cliente (4xx)
Explicação: O Content-Type enviado (ou o formato do conteúdo) não é suportado pelo servidor para esse recurso.
Exemplo de uso: Enviar XML para uma API que só aceita JSON, ou esquecer Content-Type: application/json.
Quando aparece: Erro comum ao integrar APIs.
Referência: RFC 9110, seção 15.5.16

Link direto para o 415

416Range Not Satisfiable · Intervalo não satisfatório

O intervalo pedido em Range está fora do tamanho do recurso.

Código: 416 — Range Not Satisfiable
Categoria: Erro do cliente (4xx)
Explicação: O cliente pediu uma parte do recurso (cabeçalho Range) que o servidor não consegue fornecer. Antes da RFC 9110 o nome era Requested Range Not Satisfiable.
Exemplo de uso: Pedir bytes=5000-6000 de um arquivo de 1000 bytes.
Quando aparece: Retomada de downloads com informação desatualizada.
Referência: RFC 9110, seção 15.5.17

Link direto para o 416

417Expectation Failed · Expectativa falhou

O servidor não pode atender ao cabeçalho Expect.

Código: 417 — Expectation Failed
Categoria: Erro do cliente (4xx)
Explicação: A expectativa informada em Expect não pode ser cumprida pelo servidor (ou por um proxy no caminho).
Exemplo de uso: Um cliente envia Expect: 100-continue a um proxy que não o suporta.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.5.18

Link direto para o 417

421Misdirected Request · Requisição mal direcionada

A requisição foi enviada a um servidor que não pode atendê-la.

Código: 421 — Misdirected Request
Categoria: Erro do cliente (4xx)
Explicação: Comum com HTTP/2 quando uma conexão é reutilizada para um host que aquele servidor não atende, por exemplo por configuração de TLS/SNI.
Exemplo de uso: Um navegador reutiliza uma conexão para outro domínio que o servidor não cobre.
Quando aparece: Configurações de TLS e de hospedagem com HTTP/2.
Referência: RFC 9110, seção 15.5.20

Link direto para o 421

422Unprocessable Content · Conteúdo não processável

A sintaxe está correta, mas o conteúdo é semanticamente inválido.

Código: 422 — Unprocessable Content
Categoria: Erro do cliente (4xx)
Explicação: O servidor entendeu o formato, mas não consegue processar os dados. Antes da RFC 9110 o nome era Unprocessable Entity. É muito usado na validação de APIs.
Exemplo de uso: Enviar um JSON válido com um e-mail em formato inválido ou um campo obrigatório vazio.
Quando aparece: Erros de validação em APIs e frameworks web.
Referência: RFC 9110, seção 15.5.21

Link direto para o 422

423Locked · Bloqueado

O recurso está bloqueado.

Código: 423 — Locked
Categoria: Erro do cliente (4xx)
Explicação: Usado no WebDAV: o recurso de origem ou de destino da operação está bloqueado por outro usuário ou processo.
Exemplo de uso: Tentar editar um arquivo que outra pessoa bloqueou.
Quando aparece: Servidores WebDAV.
Referência: RFC 4918 (WebDAV)

Link direto para o 423

424Failed Dependency · Dependência falhou

A requisição falhou porque dependia de outra que falhou.

Código: 424 — Failed Dependency
Categoria: Erro do cliente (4xx)
Explicação: Usado no WebDAV: uma ação dependia de outra operação da mesma requisição, e essa outra falhou.
Exemplo de uso: Em uma operação em lote, um passo anterior falhou e impediu os seguintes.
Quando aparece: Servidores WebDAV.
Referência: RFC 4918 (WebDAV)

Link direto para o 424

425Too Early · Muito cedo

O servidor se recusa a processar uma requisição que pode ser repetida.

Código: 425 — Too Early
Categoria: Erro do cliente (4xx)
Explicação: Protege contra ataques de repetição quando a requisição chega em dados antecipados do TLS (0-RTT). O cliente pode tentar de novo depois do handshake.
Exemplo de uso: Uma requisição enviada em early data TLS que o servidor não aceita processar ainda.
Quando aparece: Raro; relacionado a TLS 1.3 com 0-RTT.
Referência: RFC 8470

Link direto para o 425

426Upgrade Required · Atualização necessária

O cliente deve mudar de protocolo para continuar.

Código: 426 — Upgrade Required
Categoria: Erro do cliente (4xx)
Explicação: O servidor recusa a requisição no protocolo atual e informa, no cabeçalho Upgrade, qual protocolo precisa ser usado.
Exemplo de uso: Um servidor exige TLS e pede ao cliente para atualizar a conexão.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.5.22

Link direto para o 426

428Precondition Required · Pré-condição necessária

O servidor exige que a requisição seja condicional.

Código: 428 — Precondition Required
Categoria: Erro do cliente (4xx)
Explicação: Evita o problema de "atualização perdida": o cliente precisa enviar condições (como If-Match) para alterar um recurso.
Exemplo de uso: Um PUT sem If-Match em uma API que só aceita atualizações condicionais.
Quando aparece: APIs com controle de concorrência.
Referência: RFC 6585

Link direto para o 428

429Too Many Requests · Muitas requisições

O cliente enviou requisições demais em pouco tempo.

Código: 429 — Too Many Requests
Categoria: Erro do cliente (4xx)
Explicação: É o limite de taxa (rate limiting). O cabeçalho Retry-After pode indicar quando tentar de novo.
Exemplo de uso: Um script que chama uma API centenas de vezes por segundo.
Quando aparece: APIs com limite de uso e proteção contra abuso.
Referência: RFC 6585

Link direto para o 429

431Request Header Fields Too Large · Cabeçalhos grandes demais

Os cabeçalhos da requisição são grandes demais.

Código: 431 — Request Header Fields Too Large
Categoria: Erro do cliente (4xx)
Explicação: Um cabeçalho específico, ou o conjunto deles, passou do limite do servidor. É comum quando cookies acumulam muito conteúdo.
Exemplo de uso: Um navegador envia cookies enormes a um servidor com limite baixo.
Quando aparece: Cookies muito grandes ou cabeçalhos excessivos.
Referência: RFC 6585

Link direto para o 431

451Unavailable For Legal Reasons · Indisponível por razões legais

O recurso foi bloqueado por exigência legal.

Código: 451 — Unavailable For Legal Reasons
Categoria: Erro do cliente (4xx)
Explicação: O servidor nega o acesso por uma demanda legal, como ordem judicial ou restrição regional. O número é uma referência ao livro Fahrenheit 451.
Exemplo de uso: Um conteúdo removido por decisão judicial em determinado país.
Quando aparece: Bloqueios legais e regionais.
Referência: RFC 7725

Link direto para o 451

5xx — Erros do servidor

A requisição parece válida, mas o servidor falhou ao atendê-la. A correção costuma estar no lado do servidor.

500Internal Server Error · Erro interno do servidor

O servidor encontrou uma situação inesperada e falhou.

Código: 500 — Internal Server Error
Categoria: Erro do servidor (5xx)
Explicação: É o erro genérico do lado do servidor: exceção não tratada, bug ou configuração incorreta. O cliente não tem como corrigir; é preciso olhar os logs do servidor.
Exemplo de uso: Um sistema com uma exceção não tratada ao processar um formulário.
Quando aparece: Bugs no código do servidor e erros de configuração.
Referência: RFC 9110, seção 15.6.1

Link direto para o 500

501Not Implemented · Não implementado

O servidor não reconhece o método ou não tem a funcionalidade.

Código: 501 — Not Implemented
Categoria: Erro do servidor (5xx)
Explicação: O servidor não suporta o recurso necessário para atender à requisição, como um método HTTP incomum.
Exemplo de uso: Enviar um método que o servidor não implementa.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.6.2

Link direto para o 501

502Bad Gateway · Gateway inválido

Um gateway ou proxy recebeu uma resposta inválida do servidor de origem.

Código: 502 — Bad Gateway
Categoria: Erro do servidor (5xx)
Explicação: O servidor que faz a ponte (proxy reverso, balanceador, CDN) falou com o servidor de origem e recebeu uma resposta inválida ou nenhuma resposta válida.
Exemplo de uso: O Nginx na frente de uma aplicação cujo processo caiu.
Quando aparece: Aplicação fora do ar atrás de proxy ou balanceador.
Referência: RFC 9110, seção 15.6.3

Link direto para o 502

503Service Unavailable · Serviço indisponível

O servidor está temporariamente incapaz de atender.

Código: 503 — Service Unavailable
Categoria: Erro do servidor (5xx)
Explicação: Costuma indicar sobrecarga ou manutenção programada. O cabeçalho Retry-After pode informar quando voltar a tentar.
Exemplo de uso: Um site em manutenção, ou sobrecarregado em um pico de acessos.
Quando aparece: Manutenções e picos de tráfego.
Referência: RFC 9110, seção 15.6.4

Link direto para o 503

504Gateway Timeout · Tempo do gateway esgotado

O gateway não recebeu resposta do servidor de origem a tempo.

Código: 504 — Gateway Timeout
Categoria: Erro do servidor (5xx)
Explicação: O proxy ou balanceador esperou o servidor de origem e estourou o tempo limite. Difere do 502, em que houve resposta, mas inválida.
Exemplo de uso: Uma consulta lenta a banco de dados que passa do tempo limite do proxy.
Quando aparece: Processamentos lentos atrás de proxy ou balanceador.
Referência: RFC 9110, seção 15.6.5

Link direto para o 504

505HTTP Version Not Supported · Versão HTTP não suportada

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

Código: 505 — HTTP Version Not Supported
Categoria: Erro do servidor (5xx)
Explicação: O servidor se recusa a atender requisições naquela versão principal do protocolo.
Exemplo de uso: Um cliente antigo ou muito novo falando uma versão que o servidor não aceita.
Quando aparece: Raro.
Referência: RFC 9110, seção 15.6.6

Link direto para o 505

506Variant Also Negotiates · Variante também negocia

Erro de configuração na negociação transparente de conteúdo.

Código: 506 — Variant Also Negotiates
Categoria: Erro do servidor (5xx)
Explicação: A variante escolhida pelo servidor é, ela mesma, configurada para negociar, o que cria uma referência circular.
Exemplo de uso: Um servidor mal configurado para negociação transparente de conteúdo.
Quando aparece: Muito raro.
Referência: RFC 2295

Link direto para o 506

507Insufficient Storage · Armazenamento insuficiente

O servidor não tem espaço para concluir a requisição.

Código: 507 — Insufficient Storage
Categoria: Erro do servidor (5xx)
Explicação: Usado no WebDAV: não há armazenamento suficiente para guardar o resultado da operação.
Exemplo de uso: Salvar um arquivo em um servidor WebDAV cujo disco está cheio.
Quando aparece: Servidores WebDAV sem espaço.
Referência: RFC 4918 (WebDAV)

Link direto para o 507

508Loop Detected · Loop detectado

O servidor detectou um loop infinito ao processar a requisição.

Código: 508 — Loop Detected
Categoria: Erro do servidor (5xx)
Explicação: Usado no WebDAV: a operação entraria em ciclo, por exemplo ao percorrer uma coleção que contém a si mesma.
Exemplo de uso: Copiar uma pasta que contém um vínculo para ela mesma.
Quando aparece: Servidores WebDAV.
Referência: RFC 5842 (WebDAV)

Link direto para o 508

510Not Extended · Não estendido

A requisição precisa de extensões adicionais para ser atendida.

Código: 510 — Not Extended
Categoria: Erro do servidor (5xx)
Explicação: Definido na RFC 2774 (extensões HTTP), hoje histórico: o servidor exige uma extensão que a requisição não declarou.
Exemplo de uso: Quase nunca visto na prática.
Quando aparece: Muito raro.
Referência: RFC 2774 (histórico)

Link direto para o 510

511Network Authentication Required · Autenticação de rede necessária

O cliente precisa se autenticar para acessar a rede.

Código: 511 — Network Authentication Required
Categoria: Erro do servidor (5xx)
Explicação: Usado por quem intercepta o tráfego para exigir login, como portais de Wi-Fi em hotéis e aeroportos. Não vem do servidor de destino.
Exemplo de uso: Abrir um site na rede Wi-Fi de um aeroporto antes de aceitar os termos.
Quando aparece: Portais cativos de redes Wi-Fi.
Referência: RFC 6585

Link direto para o 511

Esta página é uma referência: ela não consulta nenhum site. A busca roda no seu navegador e o que você digita não é enviado a servidores nem às métricas de uso.

O que são códigos de status HTTP?

Todo servidor web responde a uma requisição com um código de status de três dígitos, que resume o resultado: deu certo, o recurso mudou de lugar, a requisição tem um problema ou o servidor falhou. Quem navega quase só vê o código quando algo dá errado (como o famoso 404), mas ele está em toda resposta, inclusive nas bem-sucedidas (200).

Os códigos servem a pessoas que desenvolvem e a quem administra sites: indicam por onde começar a investigar um problema, orientam navegadores e buscadores (um 301 diz que a página mudou de endereço) e definem o comportamento de APIs. Esta página lista os códigos padronizados (registro IANA e RFCs); não há consulta a sites reais.

Categorias de status: 1xx a 5xx

O primeiro dígito indica a classe da resposta:

1xx — Informativos: a requisição foi recebida e o processo continua.
2xx — Sucesso: a requisição foi aceita e processada.
3xx — Redirecionamento: é preciso uma ação adicional, normalmente seguir para outro endereço.
4xx — Erros do cliente: a requisição tem um problema, como endereço inexistente ou falta de permissão.
5xx — Erros do servidor: a requisição era válida, mas o servidor falhou ao atendê-la.

Uma regra prática: erros 4xx pedem correção em quem faz a requisição; erros 5xx pedem correção no servidor.

Os códigos mais comuns

200 OK: tudo certo; é a resposta típica de uma página ou API que funcionou.
301 Moved Permanently: a página mudou de endereço para sempre; buscadores passam a indexar o novo endereço.
302 Found: o redirecionamento é temporário; o endereço original continua valendo.
400 Bad Request: a requisição está malformada, por exemplo com um JSON inválido.
401 Unauthorized: falta autenticação válida (você não se identificou ou o token expirou).
403 Forbidden: o servidor sabe o que você quer, mas não deixa: falta permissão.
404 Not Found: o endereço não existe ou não existe mais.
500 Internal Server Error: falha genérica do servidor, geralmente um bug ou erro de configuração.
502 Bad Gateway: o proxy ou balanceador recebeu uma resposta inválida do servidor de origem.
503 Service Unavailable: o serviço está temporariamente fora, por manutenção ou sobrecarga.
504 Gateway Timeout: o proxy esperou o servidor de origem e o tempo acabou.

Diferenças que mais confundem

301 × 302 (e 307 × 308): o 301 é permanente e o 302 é temporário. Em ambos, alguns clientes trocam POST por GET; para manter o método, use 308 (permanente) ou 307 (temporário).

401 × 403: o 401 diz "não sei quem você é" (autenticação); o 403 diz "sei quem você é, mas você não pode" (autorização). Autenticar de novo resolve o 401, mas não o 403.

502 × 503 × 504: nos três o problema está do lado do servidor. No 502 o intermediário recebeu uma resposta inválida; no 503 o serviço está indisponível de propósito ou por sobrecarga; no 504 o intermediário não recebeu resposta a tempo.

E o 418? O "I'm a teapot" é uma piada de 1º de abril (RFC 2324, protocolo para bules de café) e está reservado no registro IANA; não é um código HTTP oficial, por isso não aparece na lista.

Como usar esta referência

Digite um número (404), parte do nome (not found) ou um tema (redirect, server error) e a lista é filtrada na hora. Pesquisar um código exato abre os detalhes dele; os botões de categoria (1xx a 5xx) restringem a lista. Cada código tem um link direto, como #404. Para analisar o endereço de uma requisição, use o Gerador e Analisador de URL; para trabalhar com redes, veja a Calculadora de Sub-rede IPv4.

Perguntas frequentes

O que significa HTTP 404?

Significa "Not Found": o servidor não encontrou o recurso pedido. Acontece com links quebrados, endereços digitados errado e páginas removidas.

O que significa HTTP 301?

Significa "Moved Permanently": o recurso mudou de endereço de forma permanente e o novo endereço vem no cabeçalho Location. Buscadores passam a indexar o novo endereço.

Qual a diferença entre 401 e 403?

O 401 indica que falta autenticação válida (o servidor não sabe quem você é). O 403 indica que o servidor sabe quem você é, ou não precisa saber, e mesmo assim recusa a requisição por falta de permissão.

O que significa HTTP 500?

Significa "Internal Server Error": uma falha genérica no servidor, como uma exceção não tratada ou configuração errada. O cliente não consegue corrigir; é preciso olhar os logs do servidor.

O que significa HTTP 503?

Significa "Service Unavailable": o servidor está temporariamente incapaz de atender, por sobrecarga ou manutenção. Pode vir com o cabeçalho Retry-After indicando quando tentar de novo.

Outras ferramentas

← Ver todas as ferramentas