Ferramentas para programadores
Referência de códigos de estado HTTP
Pesquise todos os códigos de estado HTTP de 100 a 511 com explicações claras, categorias e ligações às especificações.
61 códigos de estado
- 100ContinueRFC 9110 · MDN
O servidor recebeu os cabeçalhos; o cliente deve enviar o corpo.
- 101Switching ProtocolsRFC 9110 · MDN
O servidor muda de protocolo como pedido, por exemplo para WebSocket.
- 102ProcessingRFC 2518 · MDN
O servidor ainda está a processar um pedido WebDAV longo; ainda sem resposta.
- 103Early HintsRFC 8297 · MDN
Cabeçalhos preliminares para o navegador começar a pré-carregar recursos mais cedo.
O pedido foi bem-sucedido. O corpo contém o recurso ou o resultado pedido.
Sucesso e foi criado um novo recurso, normalmente após um POST.
- 202AcceptedRFC 9110 · MDN
O pedido foi aceite, mas o processamento ainda não terminou.
- 203Non-Authoritative InformationRFC 9110 · MDN
Sucesso, mas a resposta foi alterada por um proxy em relação ao original.
Sucesso sem corpo de resposta, comum em DELETE ou formulários guardados.
- 205Reset ContentRFC 9110 · MDN
Sucesso; o cliente deve repor o formulário ou a vista que enviou o pedido.
- 206Partial ContentRFC 9110 · MDN
Só é devolvida parte do recurso, como pedido pelo cabeçalho Range.
- 207Multi-StatusRFC 4918 · MDN
Resposta WebDAV com estados separados para vários recursos.
- 208Already ReportedRFC 5842 · MDN
Os membros WebDAV já foram listados antes nesta resposta.
- 226IM UsedRFC 3229 · MDN
O servidor aplicou manipulações de instância (codificação delta) à resposta.
- 300Multiple ChoicesRFC 9110 · MDN
O recurso tem várias representações à escolha.
O recurso mudou permanentemente; atualize ligações e marcadores.
O recurso está temporariamente noutro URL; continue a usar o original.
- 303See OtherRFC 9110 · MDN
Obtenha o resultado com GET noutro URL, muitas vezes após o POST de um formulário.
A cópia em cache continua válida, por isso não é enviado corpo.
- 307Temporary RedirectRFC 9110 · MDN
Redirecionamento temporário que mantém o método e o corpo.
- 308Permanent RedirectRFC 9110 · MDN
Redirecionamento permanente que mantém o método e o corpo.
O servidor não consegue processar o pedido porque está mal formado ou é inválido.
É necessária autenticação ou as credenciais fornecidas são inválidas.
- 402Payment RequiredRFC 9110 · MDN
Reservado para pagamentos; algumas APIs usam-no quando um plano ou quota exige pagamento.
O servidor percebeu o pedido mas recusa autorizá-lo.
O servidor não encontra o recurso pedido.
O método HTTP não é suportado para este recurso.
- 406Not AcceptableRFC 9110 · MDN
Nenhuma representação corresponde aos cabeçalhos Accept do cliente.
- 407Proxy Authentication RequiredRFC 9110 · MDN
O cliente tem primeiro de se autenticar no proxy.
- 408Request TimeoutRFC 9110 · MDN
O servidor esperou demasiado que o cliente terminasse o pedido.
O pedido entra em conflito com o estado atual do recurso.
- 410GoneRFC 9110 · MDN
O recurso foi removido permanentemente e não vai voltar.
- 411Length RequiredRFC 9110 · MDN
O servidor exige um cabeçalho Content-Length.
- 412Precondition FailedRFC 9110 · MDN
Falhou uma condição prévia nos cabeçalhos, como If-Match.
- 413Content Too LargeRFC 9110 · MDN
O corpo do pedido é maior do que o servidor permite.
- 414URI Too LongRFC 9110 · MDN
O URL é mais longo do que o servidor está disposto a tratar.
- 415Unsupported Media TypeRFC 9110 · MDN
O servidor não suporta o formato do corpo do pedido.
- 416Range Not SatisfiableRFC 9110 · MDN
O intervalo (Range) pedido não pode ser servido para o recurso.
- 417Expectation FailedRFC 9110 · MDN
O servidor não consegue cumprir o requisito do cabeçalho Expect.
- 418I'm a teapotRFC 2324 · MDN
Uma piada do 1.º de abril: o servidor é um bule e recusa-se a fazer café.
- 421Misdirected RequestRFC 9110 · MDN
O pedido chegou a um servidor que não pode responder por este anfitrião.
O pedido está bem formado mas tem erros semânticos ou de validação.
- 423LockedRFC 4918 · MDN
O recurso WebDAV está bloqueado.
- 424Failed DependencyRFC 4918 · MDN
O pedido falhou porque falhou um pedido do qual dependia.
- 425Too EarlyRFC 8470 · MDN
O servidor não processa um pedido que possa ser repetido.
- 426Upgrade RequiredRFC 9110 · MDN
O cliente tem de mudar para outro protocolo, como TLS ou HTTP/2.
- 428Precondition RequiredRFC 6585 · MDN
O servidor exige um pedido condicional para evitar alterações perdidas.
O cliente enviou demasiados pedidos em pouco tempo (limitação de taxa).
- 431Request Header Fields Too LargeRFC 6585 · MDN
Os cabeçalhos do pedido, ou um só, são demasiado grandes.
- 451Unavailable For Legal ReasonsRFC 7725 · MDN
O recurso está indisponível por motivos legais, como uma ordem judicial.
O servidor teve um erro inesperado e não conseguiu concluir o pedido.
- 501Not ImplementedRFC 9110 · MDN
O servidor não suporta a funcionalidade necessária para este pedido.
Um gateway ou proxy recebeu uma resposta inválida do servidor de origem.
O servidor está temporariamente sobrecarregado ou em manutenção.
Um gateway ou proxy não recebeu a tempo uma resposta da origem.
- 505HTTP Version Not SupportedRFC 9110 · MDN
O servidor não suporta a versão de HTTP usada no pedido.
- 506Variant Also NegotiatesRFC 2295 · MDN
A negociação de conteúdo está mal configurada no servidor.
- 507Insufficient StorageRFC 4918 · MDN
O servidor não consegue guardar o necessário para concluir o pedido.
- 508Loop DetectedRFC 5842 · MDN
O servidor detetou um ciclo infinito ao processar o pedido.
- 510Not ExtendedRFC 2774 · MDN
O servidor precisa de extensões adicionais para cumprir o pedido.
- 511Network Authentication RequiredRFC 6585 · MDN
O cliente tem de se autenticar para aceder à rede, p. ex. num portal Wi-Fi.
O que é esta ferramenta?
Cada resposta HTTP traz um código de três dígitos que diz ao cliente o que aconteceu. Pesquise por número ou nome, filtre por classe e leia o que cada código significa e quando usá-lo — de 200 OK e redirecionamentos 301 até 404, 429 e 503.
Os códigos agrupam-se pelo primeiro dígito: 2xx significa sucesso, 3xx que o cliente tem de fazer outra coisa (normalmente seguir um redirecionamento), 4xx que o pedido estava errado e 5xx que o servidor falhou.
A lista segue a RFC 9110 (semântica HTTP) e as outras RFC que registaram códigos extra, como 429 Too Many Requests (RFC 6585) e 451 Unavailable For Legal Reasons (RFC 7725).
Como usar: Códigos de estado HTTP
- Escreva um código (como 404) ou uma palavra (como redirecionamento) na caixa de pesquisa.
- Filtre por classe: 1xx informativos, 2xx sucesso, 3xx redirecionamento, 4xx erros do cliente ou 5xx erros do servidor.
- Marque «Só os mais comuns» para ver os códigos com que se vai cruzar mais vezes.
- Copie um código e o seu nome, ou abra a página MDN com todos os detalhes.
Exemplos
Redirecionamentos
301 e 308 são permanentes; 302, 303 e 307 são temporários. 307 e 308 mantêm o método e o corpo originais.
Perguntas frequentes
Qual é a diferença entre 401 e 403?
401 Unauthorized significa que não está autenticado (inicie sessão ou envie um token válido). 403 Forbidden significa que o servidor sabe quem é, mas não tem permissão.
Uso 301 ou 302 num redirecionamento?
Use 301 (ou 308) quando a mudança é permanente, para que os motores de busca transfiram o ranking para o novo URL. Use 302 (ou 307) em redirecionamentos temporários.
Quando deve uma API devolver 422?
Quando o pedido é JSON (ou um formulário) válido mas falha a validação — por exemplo falta um campo obrigatório ou o e-mail é inválido. Use 400 para pedidos mal formados.
O que significa 503 Service Unavailable?
O servidor não consegue tratar pedidos temporariamente, muitas vezes por manutenção ou sobrecarga. Um cabeçalho Retry-After pode dizer aos clientes quando tentar de novo.
Vai precisar de mais capacidades no futuro?
Ferramentas premium, limites mais altos e acesso por API estão nos nossos planos. A V1 continua gratuita e privada no seu navegador.