Referência de códigos de estado HTTP
Uma referência completa e pesquisável de todos os códigos de estado HTTP, de 100 a 511. Navegue por categoria, pesquise por palavra-chave ou número de código e expanda qualquer código para ver todos os detalhes, incluindo orientações práticas de uso e especificações RFC — tudo no seu navegador e sem registo.
1xx Informational
(4)The server has received the request headers and the client should proceed to send the request body.
The server is switching protocols as requested by the client via the Upgrade header.
The server has received and is processing the request, but no response is available yet.
The server is sending preliminary headers to allow the client to preload resources before the final response.
2xx Success
(10)The request has succeeded. The meaning depends on the HTTP method used.
The request has been fulfilled and a new resource has been created.
The request has been accepted for processing, but the processing has not been completed.
The returned metadata is not exactly the set available from the origin server but is gathered from a local or third-party copy.
The server has fulfilled the request but does not need to return a response body.
The server has fulfilled the request and the user agent should reset the document view.
The server is delivering only part of the resource due to a Range header sent by the client.
Provides status for multiple independent operations in WebDAV.
The members of a DAV binding have already been enumerated in a previous reply to this request.
The server has fulfilled a GET request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance.
3xx Redirection
(9)The request has more than one possible response. The user agent or user should choose one.
The resource has been permanently moved to a new URL indicated by the Location header.
The resource has been temporarily moved to a different URL.
The response to the request can be found at another URL using a GET method.
The resource has not been modified since the last request, and the client should use its cached version.
The requested resource must be accessed through the proxy specified in the Location header.
Subsequent requests should use the specified proxy.
The resource has been temporarily moved, and the client should use the same HTTP method for the redirect.
The resource has been permanently moved, and the client should use the same HTTP method for the redirect.
4xx Client Error
(29)The server cannot process the request due to a client error (malformed syntax, invalid request message framing, or deceptive request routing).
The request requires user authentication. The response must include a WWW-Authenticate header.
This response code is reserved for future use. Originally intended for digital payment systems.
The client does not have access rights to the content, and the server is refusing to respond.
The server cannot find the requested resource. In an API, this can also mean the endpoint is valid but the resource itself does not exist.
The request method is known by the server but is not supported by the target resource.
The server cannot produce a response matching the list of acceptable values defined in the request headers.
The client must first authenticate itself with the proxy.
The server timed out waiting for the request.
The request conflicts with the current state of the server.
The requested resource is no longer available and will not be available again.
The server refuses to accept the request without a defined Content-Length header.
One or more conditions given in the request header fields evaluated to false.
The request entity is larger than the server is willing or able to process.
The URI provided in the request was too long for the server to process.
The media format of the requested data is not supported by the server.
The range specified in the Range header cannot be satisfied.
The expectation indicated by the Expect request header field cannot be met by the server.
The server refuses to brew coffee because it is, permanently, a teapot.
The request was directed at a server that cannot produce a response for the target resource.
The request body contains well-formed but semantically erroneous content.
The resource that is being accessed is locked.
The request failed because it depended on another operation that failed.
The server is unwilling to risk processing a request that might be replayed.
The client should switch to a different protocol as specified in the Upgrade header.
The server requires the request to be conditional to prevent the lost update problem.
The user has sent too many requests in a given amount of time (rate limiting).
The server refuses to process the request because the header fields are too large.
The resource is unavailable due to legal demands (government censorship, copyright claims).
5xx Server Error
(11)The server encountered an unexpected condition that prevented it from fulfilling the request.
The server does not support the functionality required to fulfill the request.
The server, while acting as a gateway or proxy, received an invalid response from the upstream server.
The server is currently unable to handle the request due to temporary overload or maintenance.
The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server.
The server does not support the HTTP protocol version used in the request.
The server has an internal configuration error and the chosen variant resource is configured to engage in transparent content negotiation itself.
The server is unable to store the representation needed to complete the request.
The server detected an infinite loop while processing a request with "Depth: infinity".
Further extensions to the request are required for the server to fulfill it.
The client needs to authenticate to gain network access (e.g., captive portal).
Por que usar a nossa referência de códigos de estado HTTP?
Uma referência completa e pensada para programadores com todos os códigos de estado HTTP padrão de 1xx a 5xx, incluindo os códigos WebDAV e experimentais.
Todos os códigos de estado HTTP padrão de 100 a 511, incluindo as categorias informativa, de sucesso, de redirecionamento, de erro do cliente e de erro do servidor. Além disso, códigos WebDAV e códigos de estado experimentais — tudo num só lugar.
Pesquise por número de código, título, descrição, notas de uso ou especificação RFC. Filtre por categoria (1xx-5xx) ou veja todos os códigos de uma vez. A pesquisa atualiza-se em tempo real em todo o conjunto de dados.
Clique em qualquer código de estado para expandir informações detalhadas: descrição completa, notas práticas de uso, referência à especificação RFC e função de cópia — mantendo a vista compacta limpa e fácil de percorrer.
Copie qualquer código de estado com o respetivo título diretamente para a área de transferência com um clique. Cada código mostra a sua fonte de especificação RFC e a sua categoria, para citação fácil em documentação, revisões de código e depuração.
Quem usa as referências de códigos de estado HTTP?
De programadores de frontend a designers de API, o acesso rápido a informação precisa sobre códigos de estado HTTP é essencial.
Devolva os códigos de estado corretos a partir das API de backend. Saiba quando usar 201 em vez de 202, 400 em vez de 422, ou 301 em vez de 308 na sua aplicação Express, Django, Rails ou ASP.NET.
Conceba API RESTful com semântica precisa de códigos de estado. Escolha os códigos adequados para operações CRUD, respostas de erro, limitação de pedidos e estratégias de negociação de conteúdo.
Consulte rapidamente códigos de estado desconhecidos que surjam durante a depuração, testes de API com Postman/cURL, análise de logs ou revisão de relatórios de erro do servidor.
Interprete códigos de estado HTTP em logs de balanceadores de carga, relatórios de CDN, painéis de monitorização e alertas de disponibilidade. Perceba a diferença entre 502 e 504 ao diagnosticar problemas de gateway.
Estude os fundamentos do protocolo HTTP com explicações claras e práticas. Aprenda a diferença entre erros 4xx e 5xx, quando ocorrem redirecionamentos e como a cache usa o 304.
Consulte descrições precisas de códigos de estado, referências de especificações e notas de uso ao escrever documentação de API, tutoriais, manuais de erros e guias de programação.
O que são códigos de estado HTTP?
Os códigos de estado HTTP são números padronizados de três dígitos devolvidos pelos servidores web em cada resposta HTTP. Dividem-se em cinco classes indicadas pelo primeiro dígito: 1xx (informativa), 2xx (sucesso), 3xx (redirecionamento), 4xx (erro do cliente) e 5xx (erro do servidor). Cada código comunica uma condição específica do pedido, permitindo aos clientes (navegadores, API, aplicações móveis) determinar a ação seguinte adequada. A especificação HTTP atual (RFC 9110) define a semântica principal, e outros RFC complementares definem códigos adicionais para WebDAV, limitação de pedidos, restrições legais e outros casos de uso especializados.
Como funciona a nossa referência
- Navegue por categoria: use os botões de filtro para ver apenas os códigos informativos (1xx), de sucesso (2xx), de redirecionamento (3xx), de erro do cliente (4xx) ou de erro do servidor (5xx).
- Pesquise: escreva qualquer número de código, palavra-chave do título ou um termo como «cache» ou «redirecionamento» para encontrar instantaneamente os códigos relevantes em todo o conjunto de dados.
- Expanda para ver detalhes: clique em qualquer cartão de código de estado para ver a descrição completa, orientações práticas de uso e a referência à especificação RFC.
- Copie e cite: clique no botão de cópia de qualquer código para o copiar com o seu título e usá-lo em código, documentação ou notas de depuração.
Compreender as categorias de códigos de estado
- 1xx informativa (100-199): respostas provisórias que indicam que o servidor recebeu o pedido e continua a processá-lo. São respostas intermédias antes da resposta final.
- 2xx sucesso (200-299): o pedido foi recebido, compreendido e aceite com êxito. O código concreto indica o que foi feito com o pedido (criado, aceite, entregue parcialmente).
- 3xx redirecionamento (300-399): o cliente tem de tomar uma ação adicional para concluir o pedido. Normalmente significa que o recurso foi movido e que o cliente deve seguir o URL do cabeçalho Location.
- 4xx erro do cliente (400-499): o pedido contém sintaxe incorreta ou não pode ser satisfeito pelo servidor. Estes erros são responsabilidade do cliente — entrada inválida, falha de autenticação, recurso não encontrado.
- 5xx erro do servidor (500-599): o servidor não conseguiu satisfazer um pedido válido devido a erro interno, falta de capacidade ou falha a montante. O cliente pode repetir o pedido mais tarde.
Privacidade, segurança e disponibilidade
Esta referência de códigos de estado HTTP é uma ferramenta de consulta estática. Nenhum dado é enviado, armazenado ou processado em qualquer servidor. O conjunto completo de códigos de estado está incorporado na página e carrega instantaneamente sem qualquer pedido de rede. Sem conta, sem registo e sem rastreamento. A ferramenta é 100% grátis e sem limites de uso.
Perguntas frequentes
Mais de 50 códigos padrão de 1xx a 5xx, incluindo os códigos WebDAV e experimentais.
Sim, códigos obsoletos como 305 e 306 estão incluídos com notas de obsolescência.
Sim, a pesquisa abrange todos os campos, incluindo a referência à especificação RFC (por exemplo, pesquisar «RFC 6585»).
Cinco categorias pelo primeiro dígito, com código de cor: 1xx azul, 2xx verde, 3xx amarelo, 4xx laranja, 5xx vermelho.
Sim, clique no botão de cópia de qualquer cartão para copiar o código e o respetivo título para a área de transferência.
O 400 é para sintaxe malformada; o 422, para conteúdo bem formado mas semanticamente inválido.
Sim. Isto é uma referência estática — nenhum dado é enviado ou armazenado em qualquer lugar.
Sim, 100% grátis, sem limites, sem registo e sem cobranças ocultas.