Referência de Códigos de Status HTTP
Referência pesquisável completa para todos os códigos de status HTTP padrão — 1xx a 5xx. Filtre por categoria, pesquise por número de código ou descrição.
Referência de Códigos de Status HTTP
Showing 60 of 60 codes
Server has received request headers; client should proceed.
Server is switching to a different protocol as requested.
The request succeeded.
A new resource was successfully created.
Request accepted but not yet completed.
Metadata differs from the origin server.
Request succeeded; no response body.
Request succeeded; client should reset the document view.
Partial resource returned due to range request.
Multiple status codes for multiple operations.
Members already enumerated in a previous reply.
Response is a result of instance manipulations.
Multiple representations available; user must choose.
Resource permanently moved to a new URL.
Resource temporarily at a different URL.
Redirect to a different URL with GET.
Resource unchanged; use cached version.
Must access through a specified proxy.
Temporary redirect; preserve HTTP method.
Permanent redirect; preserve HTTP method.
Server cannot process the request due to client error.
Authentication is required.
Payment required to access this resource.
Server refuses to fulfil the request.
The requested resource does not exist.
HTTP method not supported for this endpoint.
Cannot produce a response matching Accept headers.
Proxy authentication is required.
Server timed out waiting for the request.
Request conflicts with the current state.
Resource permanently deleted and will not return.
Content-Length header is required.
Precondition in headers evaluated to false.
Request body exceeds server size limit.
The request URL is too long.
Request Content-Type is not supported.
Requested byte range cannot be satisfied.
Server cannot meet the Expect header requirement.
The server is a teapot — an April Fools' joke code.
Request directed at a server unable to produce a response.
Request is well-formed but contains semantic errors.
The resource is locked (WebDAV).
Request failed because a dependency failed (WebDAV).
Server unwilling to process a potentially replayed request.
Client must upgrade to a different protocol.
Conditional request header required.
Rate limit exceeded.
Request headers are too large.
Resource unavailable due to legal restrictions.
Unexpected server-side error.
Server does not support the request method.
Invalid response from an upstream server.
Server temporarily unable to handle the request.
Upstream server did not respond in time.
HTTP version not supported.
Content negotiation circular reference.
Server has insufficient storage (WebDAV).
Infinite loop detected (WebDAV).
Further extensions required to process the request.
Client must authenticate to access the network.
O que são códigos de status HTTP?
Códigos de status HTTP são números de três dígitos retornados por um servidor em resposta a uma solicitação do cliente. O primeiro dígito define a classe de resposta: 1xx informativo, 2xx sucesso, 3xx redirecionamento, 4xx erros do cliente e 5xx erros do servidor. Toda resposta HTTP deve incluir um código de status.
Por que os códigos de status são importantes?
Os códigos de status são a forma principal como os servidores web comunicam o resultado de uma solicitação. Códigos de status corretos melhoram o SEO (ex. 301 vs 302 para redirecionamentos), permitem o tratamento adequado de erros nos clientes e são críticos para o design de APIs REST. Usar o código errado pode causar problemas de cache, quebrar a lógica do cliente ou enganar os rastreadores de mecanismos de busca.
Como usar
- Digite um número de código ou palavra-chave na caixa de pesquisa para filtrar instantaneamente.
- Clique em uma guia de categoria para restringir os resultados a uma classe específica.
- Clique em qualquer linha para expandir a descrição completa, notas de uso e causas comuns.
- Use o botão Copiar em qualquer linha para copiar o código numérico para sua área de transferência.
Perguntas Frequentes
- Qual é a diferença entre 301 e 302?
- Um 301 Moved Permanently informa aos clientes e mecanismos de busca que um recurso se moveu para uma nova URL permanentemente — os clientes devem atualizar marcadores e os mecanismos de busca transferem a autoridade de link. Um 302 Found é um redirecionamento temporário; os clientes devem continuar usando a URL original para solicitações futuras.
- Quando devo usar 400 vs 422?
- Use 400 Bad Request para sintaxe malformada ou campos obrigatórios ausentes que tornam a solicitação não analisável. Use 422 Unprocessable Content (anteriormente 422 Unprocessable Entity) quando a sintaxe é válida, mas as instruções contidas não podem ser seguidas — por exemplo, um corpo JSON bem formado, mas que falha em regras de validação de negócio.
- O que significa 503 e como é diferente de 500?
- 500 Internal Server Error significa que o servidor encontrou uma condição inesperada — um genérico catch-all para exceções não tratadas. 503 Service Unavailable significa que o servidor está temporariamente incapaz de lidar com a solicitação, normalmente devido a manutenção ou sobrecarga. 503 implica um estado temporário e frequentemente é acompanhado por um cabeçalho Retry-After.
- Uma API REST deve retornar 200 ou 204 para um DELETE?
- 204 No Content é a resposta preferida para um DELETE bem-sucedido quando não há corpo para retornar. Use 200 OK se desejar retornar um corpo (ex. o recurso deletado ou uma mensagem de confirmação). Ambos estão corretos; 204 é mais amplamente usado em APIs REST modernas.