O que é um HTTP Status Code?
Um código de status HTTP é uma resposta de três dígitos enviada por um servidor web para indicar o resultado de uma solicitação do cliente. Ele ajuda tanto os navegadores quanto os desenvolvedores a entender se uma solicitação foi bem-sucedida, falhou ou requer alguma ação adicional.
Sempre que um cliente (como um navegador, uma API ou um proxy) envia uma solicitação a um servidor web, o servidor responde com um código de status que descreve como processou essa solicitação.
Esses códigos são agrupados em cinco categorias principais com base em seu primeiro dígito:
- 1xx — Informativo: A solicitação foi recebida e está sendo processada.
- 2xx — Sucesso: A solicitação foi recebida, compreendida e aceita com sucesso.
- 3xx — Redirecionamento: O cliente deve realizar outras ações para concluir a solicitação.
- 4xx — Erros do cliente: A solicitação contém erros de sintaxe ou não pode ser atendida.
- 5xx — Erros do servidor: O servidor não conseguiu atender a uma solicitação válida.
Para usuários de proxy, esses códigos fornecem informações essenciais para determinar se um problema de conexão se origina do proxy, do site de destino ou da rede entre ambos.
1xx – Informativo
| Código de status | Definição | Próximos passos |
|---|---|---|
| 100 Continuar | A parte inicial de uma solicitação foi recebida, e o cliente deve dar continuidade à solicitação. | Continue enviando a solicitação. |
| 101 Protocolos de comutação | O servidor está mudando para um protocolo diferente, conforme solicitado pelo cliente. | Certifique-se de que o cliente seja compatível com o novo protocolo. |
| 102 Em processamento | O servidor recebeu a solicitação e está processando-a, mas ainda não há nenhuma resposta disponível. | Aguarde até que o servidor conclua o processamento. |
| 103 Dicas iniciais | Fornece informações preliminares sobre a solicitação, geralmente com o objetivo de otimizar o carregamento. | Utilize as dicas para melhorar o desempenho ou a experiência do usuário. |
2xx - Sucesso
| Código de status | Definição | Próximos passos |
|---|---|---|
| 200 OK | A solicitação foi bem-sucedida, e o servidor retornou o recurso solicitado. | Não é necessária nenhuma ação; a solicitação foi bem-sucedida. |
| 201 Criado | A solicitação foi atendida, resultando na criação de um novo recurso. | Não é necessária nenhuma ação adicional; um novo recurso foi criado. |
| 202 Aceito | A solicitação foi aceita para processamento, mas o processamento ainda não foi concluído. | Aguarde até que o processamento seja concluído; verifique se há atualizações, se necessário. |
| 203 Informações não oficiais | A solicitação foi bem-sucedida, mas os metadados retornados podem não ser do servidor original. | Analise os dados retornados para garantir que atendam aos requisitos. |
| 204 Sem conteúdo | A solicitação foi bem-sucedida, mas não foi retornado nenhum conteúdo na resposta. | Não é necessária nenhuma ação; a solicitação foi bem-sucedida, mas não há conteúdo para exibir. |
| 205 Redefinir conteúdo | A solicitação foi bem-sucedida, e o cliente deve atualizar a visualização. | Redefina a exibição do documento ou do formulário para seu estado original. |
| 206 Conteúdo parcial | O servidor está retornando conteúdo parcial do recurso solicitado, geralmente devido a um cabeçalho de intervalo. | Continue solicitando mais conteúdo conforme necessário; verifique os dados recebidos. |
3xx – Redirecionamento
| Código de status | Definição | Próximos passos |
|---|---|---|
| 300 Questões de Múltipla Escolha | A solicitação tem várias respostas possíveis. O usuário ou cliente deve escolher uma delas. | Escolha uma das opções disponíveis ou modifique a solicitação para que seja mais específica. |
| 301 Movido permanentemente | O recurso solicitado foi transferido para um novo URL, e todas as solicitações futuras devem utilizar o novo URL. | Atualize seus favoritos ou referências para utilizar o novo URL. |
| 302 Encontrado | O recurso solicitado está temporariamente disponível em uma URL diferente, mas o cliente deve continuar a utilizar a URL original para solicitações futuras. | Siga a URL temporária, mas continue usando a URL original para solicitações futuras. |
| 303 Ver mais | A resposta à solicitação pode ser encontrada em uma URL diferente, utilizando o método GET. | Envie uma solicitação GET para a URL fornecida para recuperar o recurso. |
| 304 Não modificado | O recurso não foi modificado desde a última solicitação, e o cliente pode utilizar a versão armazenada em cache. | Utilize a versão em cache do recurso. |
| 305 Usar proxy | O recurso solicitado deve ser acessado por meio do proxy especificado na resposta. | Envie a solicitação novamente usando o proxy especificado. |
| 307 Redirecionamento temporário | O recurso solicitado está temporariamente disponível em uma URL diferente, e o cliente deve acessar essa URL para esta solicitação. | Siga a URL temporária para esta solicitação, mas utilize a URL original para solicitações futuras. |
| 308 Redirecionamento permanente | O recurso solicitado foi transferido permanentemente para um novo URL, e todas as solicitações futuras devem utilizar o novo URL. | Atualize todas as referências para utilizar o novo URL. |
4xx – Erro do cliente
| Código de status | Definição | Próximos passos |
|---|---|---|
| 400 Solicitação inválida | O servidor não pode processar a solicitação devido a um erro do cliente (por exemplo, sintaxe da solicitação incorreta). | Verifique a sintaxe e os parâmetros da solicitação e tente novamente. |
| 401 Acesso não autorizado | É necessária autenticação para acessar o recurso solicitado. | Forneça credenciais de autenticação válidas e tente novamente. |
| 402 Pagamento necessário | Reservado para uso futuro; normalmente indica que é necessário efetuar um pagamento para acessar o recurso. | Se for o caso, conclua o processo de pagamento. |
| 403 Acesso proibido | O servidor compreende a solicitação, mas se recusa a autorizá-la. | Certifique-se de que possui as permissões necessárias para acessar o recurso. |
| 404 Não encontrado | O servidor não consegue localizar o recurso solicitado. | Verifique se há erros na URL ou tente pesquisar o recurso. |
| 405 Método não permitido | O método de solicitação não é compatível com o recurso solicitado. | Verifique se o método HTTP correto (GET, POST, etc.) está sendo utilizado. |
| 406 Não aceitável | O servidor não consegue gerar uma resposta que seja aceitável de acordo com os cabeçalhos Accept do cliente. | Ajuste os cabeçalhos da solicitação para aceitar um formato de resposta válido. |
| 407 É necessária autenticação de proxy | O cliente deve primeiro se autenticar junto ao proxy. | Forneça credenciais válidas de autenticação de proxy. |
| Tempo limite da solicitação 408 | O servidor atingiu o tempo limite enquanto aguardava a solicitação. | Reenvie a solicitação, certificando-se de que ela seja enviada dentro do prazo permitido pelo servidor. |
| 409 Conflito | Não foi possível processar a solicitação devido a um conflito com o estado atual do recurso. | Resolva o conflito antes de tentar novamente a solicitação. |
| 410 Indisponível | O recurso solicitado não está mais disponível e não estará disponível novamente. | Remova ou atualize as referências ao recurso, uma vez que ele foi excluído permanentemente. |
| 411 Comprimento necessário | O servidor exige que o cabeçalho Content-Length esteja presente na solicitação. | Inclua o cabeçalho Content-Length na solicitação e tente novamente. |
| 412 Falha na pré-condição | O servidor não atende a uma das pré-condições especificadas nos cabeçalhos da solicitação. | Verifique as pré-condições nos cabeçalhos da solicitação e faça os ajustes necessários. |
| 413 Carga útil muito grande | A entidade da solicitação é maior do que o servidor está disposto ou é capaz de processar. | Reduza o tamanho da carga útil da solicitação e tente novamente. |
| 414 URI muito longo | O URI solicitado pelo cliente é mais longo do que o servidor está disposto a interpretar. | Encurtar a URI ou reduzir a complexidade da solicitação. |
| 415 Tipo de mídia não suportado | O formato de mídia dos dados solicitados não é compatível com o servidor. | Utilize um formato de mídia compatível na solicitação. |
| 416 Intervalo não satisfazível | O intervalo especificado no cabeçalho “Range” não pode ser atendido pelo servidor. | Modifique a solicitação de intervalo ou tente acessar o recurso completo. |
| 417 Falha na expectativa | O servidor não consegue atender aos requisitos do campo de cabeçalho de solicitação “Expect”. | Remova o cabeçalho “Expect” ou ajuste seu valor e tente novamente. |
| 429 Número excessivo de solicitações | O usuário enviou um número excessivo de solicitações a partir do mesmo endereço IP em um determinado período de tempo (“limitação de taxa”). | Aguarde e tente novamente depois de algum tempo; considere reduzir a frequência das solicitações ou distribuir as solicitações por vários endereços IP, utilizando proxies residenciais. |
5xx – Erro do servidor
| Código de status | Definição | Próximos passos |
|---|---|---|
| Erro 500 do servidor interno | O servidor encontrou uma condição inesperada que o impediu de atender à solicitação. | Verifique se há erros nos logs do servidor e corrija quaisquer falhas que estejam causando o problema. |
| 501 Não implementado | O servidor não oferece suporte à funcionalidade necessária para atender à solicitação. | Certifique-se de que o software do servidor seja capaz de processar a solicitação; considere atualizar ou substituir o servidor. |
| 502 Erro de gateway | O servidor, ao atuar como gateway ou proxy, recebeu uma resposta inválida de um servidor upstream. | Verifique o servidor de origem e as conexões de rede; resolva quaisquer problemas. |
| 503 Serviço indisponível | O servidor não está conseguindo atender à solicitação no momento, geralmente devido a uma sobrecarga temporária ou a trabalhos de manutenção. | Tente novamente mais tarde; verifique a carga do servidor ou o status da manutenção. |
| Tempo limite do gateway 504 | O servidor, ao atuar como gateway ou proxy, não recebeu uma resposta em tempo hábil de um servidor upstream. | Verifique o servidor de origem e as conexões de rede; certifique-se de que as configurações de tempo limite estejam corretas. |
| 505 Versão HTTP não suportada | O servidor não suporta a versão do protocolo HTTP utilizada na solicitação. | Utilize uma versão compatível do HTTP ou atualize o software do servidor. |
| A variante 506 também é negociável | O servidor apresentou um erro de configuração interna, causando uma referência circular. | Corrija a configuração do servidor para resolver a referência circular. |
| 507 Espaço de armazenamento insuficiente | O servidor não consegue armazenar a representação necessária para concluir a solicitação. | Libere espaço em disco ou aumente a capacidade de armazenamento no servidor. |
| Detectado loop 508 | O servidor detectou um loop infinito durante o processamento de uma solicitação. | Investigue e corrija o loop na configuração ou no código do servidor. |
| 510 Não estendido | São necessárias mais informações para que o servidor possa atender à solicitação. | Certifique-se de que a solicitação do cliente inclua as extensões necessárias. |
| 511 É necessária autenticação de rede | O cliente precisa se autenticar para obter acesso à rede. | Forneça credenciais válidas de autenticação de rede. |
Casos de uso
Monitoramento de conexões por proxy
Ao utilizar proxies para coleta de dados Na automação da web, os códigos de status revelam onde uma solicitação falhou — no proxy, no destino ou na rede. Por exemplo, um erro 403 geralmente indica um bloqueio de IP, enquanto um 407 significa autenticação por proxy falhou.
Otimização da extração de dados da Web
Os scrapers utilizam códigos de status para ajustar seu comportamento dinamicamente. A 429 Número excessivo de solicitações aciona o controle automático de tráfego ou a rotação de proxies, ajudando a manter o acesso aos sites de destino.
Melhores práticas
Registrar e categorizar códigos de status
Registre sempre os códigos de status durante raspagem ou operações de API. O reconhecimento de padrões (como picos nos erros 403 ou 429) ajuda a ajustar as configurações do proxy e dos agentes de usuário.
Utilize a lógica de repetição de tentativas e a rotação
Implemente tentativas repetidas e Rotação de IP para respostas transitórias do tipo 5xx ou 429. Isso melhora o tempo de atividade e reduz o risco de bloqueios.
Acompanhar as tendências de resposta
Defina alertas para taxas de erro incomuns a fim de detectar problemas antecipadamente — como credenciais de proxy vencidas ou alterações no site de destino.
Conclusão
Os códigos de status HTTP atuam como uma ponte de comunicação entre o cliente e o servidor, indicando se uma solicitação foi bem-sucedida, falhou ou precisa de ajustes. Para equipes que utilizam proxies, compreender esses códigos ajuda a identificar e resolver problemas mais rapidamente, melhorando a confiabilidade da conexão e a precisão dos dados.
Perguntas frequentes
Eles descrevem como um servidor respondeu à solicitação de um cliente — se foi bem-sucedida, falhou ou se requer mais ações.
Elas ajudam a identificar se um problema se origina do seu proxy, do site de destino ou da configuração do cliente.
Os erros 4xx indicam problemas no lado do cliente (por exemplo, solicitação inválida ou acesso não autorizado), enquanto os erros 5xx indicam falhas no lado do servidor.
Em muitos casos, sim. Alternar endereços IP, utilizar proxies residenciais ou realizar a autenticação corretamente costuma resolver os problemas relacionados aos códigos 4xx e 5xx.