Consulta de Códigos de Status HTTP
Referência completa de códigos de status HTTP. Consulte o significado de qualquer código de status, entenda códigos de resposta e aprenda sobre códigos de erro HTTP.
Continue
The server has received the request headers and the client should proceed to send the request body.
Switching Protocols
The requester has asked the server to switch protocols and the server has agreed.
Processing
A WebDAV request may contain many sub-requests involving file operations, requiring a long time to complete the request.
Early Hints
Used to return some response headers before final HTTP message.
OK
The request is successful. The meaning of success depends on the HTTP method used.
Created
The request has been fulfilled and a new resource has been created.
Accepted
The request has been accepted for processing, but the processing has not been completed.
Non-Authoritative Information
The request was successful but the information may have been modified by a transforming proxy.
No Content
The server successfully processed the request but is not returning any content.
Reset Content
The server successfully processed the request but is not returning any content and requires the requester to reset the document view.
Partial Content
The server is delivering only part of the resource due to a range header sent by the client.
Multi-Status
Provides status for multiple independent operations.
Already Reported
The members of a DAV binding have already been enumerated in a preceding part of the multistatus response.
IM Used
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.
Multiple Choices
The request has more than one possible response. The user agent should choose one of them.
Moved Permanently
The URL of the requested resource has been changed permanently. The new URL is given in the response.
Found
The URL of the requested resource has been changed temporarily. Further changes in the URL might be made in the future.
See Other
The server sent this response to direct the client to get the requested resource at another URI with a GET request.
Not Modified
Used for caching purposes. The client can use cached version of the response.
Use Proxy
The requested resource is available only through a proxy.
Unused
This response code is no longer used and is reserved.
Temporary Redirect
The server sends this response to direct the client to get the requested resource at another URI with the same method.
Permanent Redirect
This means the resource is now permanently located at another URI.
Bad Request
The server could not understand the request due to invalid syntax.
Unauthorized
Authentication is required and has failed or has not yet been provided.
Payment Required
This response code is reserved for future use and was originally created for digital payment systems.
Forbidden
The client does not have access rights to the content; the server is refusing to give the requested resource.
Not Found
The server can not find the requested resource. This is the most common error on the internet.
Method Not Allowed
The request method is known by the server but is not supported by the target resource.
Not Acceptable
The server cannot produce a response matching the list of acceptable values defined in the request's headers.
Proxy Authentication Required
This is similar to 401 but authentication is required to be done by a proxy.
Request Timeout
The server timed out waiting for the request. The client did not produce a request within the time the server was prepared to wait.
Conflict
This response is sent when a request conflicts with the current state of the server.
Gone
The requested content has been permanently deleted from the server with no forwarding address.
Length Required
The server rejects the request because the Content-Length header field is not defined and the server requires it.
Precondition Failed
The client has indicated preconditions in its headers which the server does not meet.
Payload Too Large
The request entity is larger than limits defined by the server.
URI Too Long
The URI requested by the client is longer than the server is willing to interpret.
Unsupported Media Type
The media format of the requested data is not supported by the server.
Range Not Satisfiable
The range specified by the Range header field in the request cannot be fulfilled.
Expectation Failed
The expectation indicated by the Expect request header field cannot be met by the server.
I'm a teapot
This code was defined in 1998 as one of the traditional IETF April Fools' jokes.
Misdirected Request
The request was directed at a server that is not able to produce a response.
Unprocessable Entity
The request was well-formed but was unable to be followed due to semantic errors.
Locked
The resource that is being accessed is locked.
Failed Dependency
The request failed because it depended on another request and that request failed.
Too Early
Indicates that the server is unwilling to risk processing a request that might be replayed.
Upgrade Required
The server refuses to perform the request using the current protocol.
Precondition Required
The origin server requires the request to be conditional.
Too Many Requests
The user has sent too many requests in a given amount of time.
Request Header Fields Too Large
The server is unwilling to process the request because its header fields are too large.
Unavailable For Legal Reasons
The server is denying access to the resource as a consequence of a legal demand.
Internal Server Error
The server has encountered a situation it does not know how to handle.
Not Implemented
The request method is not supported by the server and cannot be handled.
Bad Gateway
The server, while acting as a gateway or proxy, received an invalid response from an upstream server.
Service Unavailable
The server is not ready to handle the request. Common causes are a server that is down for maintenance or is overloaded.
Gateway Timeout
The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.
HTTP Version Not Supported
The HTTP version used in the request is not supported by the server.
Variant Also Negotiates
The server has an internal configuration error.
Insufficient Storage
The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request.
Loop Detected
The server detected an infinite loop while processing the request.
Not Extended
Further extensions to the request are required for the server to fulfill it.
Network Authentication Required
The client needs to authenticate to gain network access.
Como Usar a Consulta de Códigos de Status HTTP
Nossa ferramenta de consulta de códigos de status HTTP fornece uma referência completa para todos os códigos de status HTTP. Use-a para encontrar rapidamente informações sobre qualquer código de status:
- Busque códigos de status digitando um número de código (como '404'), nome de status (como 'not found') ou palavras-chave de descrição
- Filtre por categoria usando os botões de categoria para visualizar apenas códigos informativos, de sucesso, de redirecionamento, de erro do cliente ou de erro do servidor
- Clique em qualquer cartão de código de status para expandir e ver informações detalhadas incluindo descrição, casos de uso comuns e referência RFC
- Use o botão de copiar para copiar códigos de status para usar em documentação, comentários de código ou especificações de API
For more developer tools, check out our Toolbox homepage or explore related tools like our JSON Formatter and Hash Generator for API development workflows.
O que são Códigos de Status HTTP?
A consulta de códigos de status HTTP é essencial para desenvolvedores web, designers de API e qualquer pessoa que trabalhe com tecnologias web. Códigos de status HTTP são números de três dígitos retornados por servidores web para indicar o resultado de uma requisição HTTP. Esses códigos fornecem informações críticas sobre se uma requisição foi bem-sucedida, se ocorreu um erro ou se uma ação adicional é necessária.
Quando você visita um site ou faz uma chamada de API, o servidor responde com um código de status HTTP junto com o recurso solicitado ou uma mensagem de erro. Os códigos de status são agrupados em cinco categorias principais com base em seu primeiro dígito: respostas informativas (1xx), respostas de sucesso (2xx), redirecionamentos (3xx), erros do cliente (4xx) e erros do servidor (5xx). Entender esses códigos ajuda desenvolvedores a depurar problemas, implementar tratamento adequado de erros e criar melhores experiências do usuário.
Conhecer códigos de status HTTP é crucial para construir aplicações web e APIs robustas. O uso adequado de códigos de status melhora o tratamento de erros, permite melhor depuração, aprimora a documentação da API e ajuda a criar mensagens de erro mais intuitivas para usuários finais. Nossa ferramenta de consulta de códigos de status HTTP fornece uma referência completa para todos os códigos de status padrão e estendidos.
The official HTTP status code specifications are defined in RFC 7231 and related RFC documents maintained by the Internet Engineering Task Force (IETF). For comprehensive documentation, refer to the MDN HTTP Status Codes reference.
Categorias de Códigos de Status HTTP
Códigos de status HTTP são organizados em cinco categorias principais. Cada categoria serve a um propósito específico na comunicação HTTP:
1xx Informational Responses
Respostas informativas (100-199) indicam que a requisição foi recebida e o processo está continuando. Estas são respostas provisórias usadas durante a fase de processamento da requisição. Exemplos incluem 100 Continue, que diz ao cliente para continuar enviando o corpo da requisição, e 101 Switching Protocols, usado ao atualizar para um protocolo diferente como WebSocket.
2xx Success Responses
Respostas de sucesso (200-299) indicam que a requisição foi recebida, entendida e aceita com sucesso. O código de sucesso mais comum é 200 OK, que significa que a requisição teve sucesso. Outros códigos de sucesso importantes incluem 201 Created (para criação de recursos), 204 No Content (para operações bem-sucedidas sem corpo de resposta) e 206 Partial Content (para requisições de intervalo em downloads de arquivos).
3xx Redirection Responses
Respostas de redirecionamento (300-399) indicam que uma ação adicional precisa ser tomada para completar a requisição. Esses códigos são usados quando um recurso foi movido ou quando locais alternativos devem ser usados. Códigos de redirecionamento comuns incluem 301 Moved Permanently (para mudanças permanentes de URL e SEO), 302 Found (redirecionamento temporário) e 304 Not Modified (para otimização de cache).
4xx Client Error Responses
Respostas de erro do cliente (400-499) indicam que houve um erro com a requisição. Esses erros são responsabilidade do cliente, significando que a requisição estava malformada, não autorizada ou o recurso solicitado não existe. O erro do cliente mais famoso é 404 Not Found. Outros códigos importantes incluem 400 Bad Request (sintaxe inválida), 401 Unauthorized (autenticação necessária), 403 Forbidden (permissão negada) e 429 Too Many Requests (limitação de taxa).
5xx Server Error Responses
Respostas de erro do servidor (500-599) indicam que o servidor falhou ao atender uma requisição válida. Esses erros são responsabilidade do servidor e frequentemente indicam problemas com a configuração do servidor, banco de dados ou lógica da aplicação. Erros comuns do servidor incluem 500 Internal Server Error (falha genérica do servidor), 502 Bad Gateway (resposta inválida do servidor upstream), 503 Service Unavailable (servidor temporariamente indisponível) e 504 Gateway Timeout (timeout do servidor upstream).
Códigos de Status HTTP Mais Comuns Explicados
Embora existam dezenas de códigos de status HTTP, certos códigos são encontrados com mais frequência no desenvolvimento web. Entender esses códigos comuns é essencial para depuração e tratamento de erros eficazes:
200 OK
200 OK é a resposta de sucesso padrão para requisições HTTP. Indica que a requisição teve sucesso e a resposta contém o recurso solicitado. Este é o código de status mais comum que você encontrará em chamadas de API bem-sucedidas e carregamentos de páginas web. O corpo da resposta tipicamente contém os dados solicitados, HTML, JSON ou outros tipos de conteúdo.
201 Created
201 Created indica que um novo recurso foi criado com sucesso como resultado da requisição. Este código é tipicamente usado em resposta a requisições POST que criam novos recursos. A resposta geralmente inclui um cabeçalho Location apontando para o recurso recém-criado. Esta é uma prática padrão no design de API RESTful para endpoints de criação de recursos.
301 Moved Permanently
301 Moved Permanently indica que o recurso solicitado foi movido permanentemente para uma nova URL. Isso é crucial para SEO, pois os mecanismos de busca atualizarão seus índices para apontar para o novo local. Ao implementar redirecionamentos 301, sempre certifique-se de que a nova URL está correta, pois navegadores e mecanismos de busca armazenarão este redirecionamento permanentemente. Use isso para mudanças permanentes de URL, migrações de domínio ou ao consolidar conteúdo duplicado.
404 Not Found
404 Not Found é talvez o código de status HTTP mais reconhecível. Indica que o servidor não consegue encontrar o recurso solicitado. Isso não significa que o recurso foi permanentemente removido (isso seria 410 Gone), mas sim que não existe no local especificado. Causas comuns incluem links quebrados, páginas deletadas, URLs incorretas ou arquivos ausentes. Ao implementar páginas de erro, sempre forneça opções de navegação úteis e funcionalidade de busca para ajudar os usuários a encontrar o que estão procurando.
500 Internal Server Error
500 Internal Server Error é um erro genérico do servidor indicando que algo deu errado no lado do servidor, mas o servidor não pôde ser mais específico sobre qual era o problema. Este código deve ser usado quando uma condição inesperada ocorreu que impediu o servidor de atender a requisição. É importante registrar esses erros no servidor para fins de depuração, pois indicam problemas que precisam ser abordados no código da aplicação ou configuração do servidor.
Códigos de Status HTTP no Desenvolvimento de API
O uso adequado de códigos de status HTTP é fundamental para construir APIs REST bem projetadas. Códigos de status comunicam o resultado de operações de API de forma clara e consistente, tornando APIs mais fáceis de entender e integrar:
- Consistência: Usar códigos de status apropriados consistentemente em sua API ajuda desenvolvedores a entender e integrar com sua API mais facilmente. Siga convenções REST e padrões HTTP para garantir comportamento previsível.
- Tratamento de Erros: Diferentes códigos de status ajudam aplicações cliente a tratar erros apropriadamente. Erros 4xx indicam problemas do lado do cliente que o cliente pode potencialmente corrigir (como entrada inválida), enquanto erros 5xx indicam problemas do lado do servidor que requerem intervenção do servidor.
- Documentação: Documentar quais códigos de status seus endpoints de API podem retornar ajuda desenvolvedores a implementar tratamento adequado de erros. Inclua códigos de status em sua documentação de API, especificações OpenAPI e exemplos de código.
- Experiência do Cliente: Códigos de status bem escolhidos melhoram a experiência do cliente fornecendo informações claras e acionáveis. Por exemplo, uma resposta 429 Too Many Requests com um cabeçalho Retry-After dá aos clientes orientação específica sobre quando tentar novamente sua requisição.
Melhores Práticas para Códigos de Status HTTP
Seguir melhores práticas para códigos de status HTTP melhora a confiabilidade, manutenibilidade e usabilidade de aplicações web e APIs:
- Escolha Códigos Apropriados: Selecione códigos de status que reflitam com precisão o resultado da requisição. Não use 200 OK para condições de erro ou 500 para erros do cliente. Use o código mais específico que descreva com precisão a situação.
- Forneça Detalhes de Erro: Ao retornar códigos de status de erro (4xx, 5xx), inclua mensagens de erro detalhadas no corpo da resposta. Isso ajuda desenvolvedores a depurar problemas e fornece melhores capacidades de tratamento de erros. Inclua códigos de erro, descrições e potencialmente soluções sugeridas.
- Registro e Monitoramento: Registre todos os códigos de status não 2xx para fins de monitoramento e depuração. Rastreie taxas de erro, identifique padrões e configure alertas para picos de erro incomuns. Isso ajuda a identificar problemas antes que impactem significativamente os usuários.
- Monitoramento: Use monitoramento de códigos de status para rastrear a saúde da aplicação. Altas taxas de erros 5xx indicam problemas do servidor, enquanto altas taxas de erros 4xx podem indicar problemas do lado do cliente, uso indevido da API ou problemas de documentação que precisam de atenção.
Solução de Problemas Comuns de Códigos de Status
Entender como solucionar problemas baseados em códigos de status HTTP é uma habilidade essencial para desenvolvedores web e administradores de sistema:
Erros do Cliente (4xx): Ao encontrar erros 4xx, verifique o formato da requisição, credenciais de autenticação, permissões de autorização e se o recurso solicitado existe. Revise cabeçalhos de requisição, parâmetros de consulta e formato do corpo da requisição. Correções comuns incluem corrigir URLs, fornecer autenticação adequada, corrigir sintaxe da requisição e garantir que recursos existam.
Para 400 Bad Request, valide dados de entrada e verifique o formato da requisição. Para 401 Unauthorized, verifique tokens de autenticação ou credenciais. Para 403 Forbidden, verifique permissões do usuário e regras de autorização. Para 404 Not Found, verifique a URL do recurso e existência. Para 429 Too Many Requests, implemente limitação de taxa ou aguarde antes de tentar novamente.
Erros do Servidor (5xx): Erros 5xx indicam problemas do lado do servidor que requerem investigação. Verifique logs do servidor, conectividade do banco de dados, código da aplicação, configuração do servidor e recursos do sistema. Esses erros tipicamente requerem intervenção do desenvolvedor ou administrador do sistema para resolver.
Para 500 Internal Server Error, verifique logs da aplicação para exceções, verifique conexões do banco de dados e revise mudanças recentes no código. Para 502 Bad Gateway, verifique a saúde do servidor upstream e configuração do proxy. Para 503 Service Unavailable, verifique capacidade do servidor, verifique operações de manutenção e revise restrições de recursos. Para 504 Gateway Timeout, verifique tempos de resposta do servidor upstream e configurações de timeout.