No mundo do desenvolvimento web, os códigos de erro HTTP desempenham um papel vital em afetar a experiência do usuário e a reputação de um site. Neste artigo, consideraremos uma lista completa de códigos de erro de servidor, analisaremos seus significados e aprenderemos como interpretar efetivamente os códigos de resposta do servidor para resolver problemas e otimizar o desempenho dos aplicativos web.
O que é um código de resposta HTTP
O código de resposta HTTP é a linguagem dos servidores web que traduz as solicitações do navegador em instruções compreensíveis. É como um poeta respondendo a perguntas virtuais, dando a elas significado e direção. Os códigos de resposta nem sempre são códigos de erro HTTP. Por exemplo, “200 OK” significa que tudo está OK, mas o erro HTTP “404 Not Found” significa quando a página está perdida no espaço virtual. Cada código é uma expressão única do estado do servidor, cuja decodificação nos permite entender o que está acontecendo do outro lado do mundo virtual.
Códigos 1xx (Informações)
Os códigos de status 1xx no protocolo HTTP são um tipo de primeiro link no diálogo entre o servidor e o cliente. Em vez de fornecer uma resposta completa a uma solicitação, eles fornecem informações sobre o status atual, tornando a troca de dados mais eficiente. Vamos dar uma olhada mais de perto neles:
100 Continue . Código de resposta HTTP no qual o servidor dá sinal verde ao usuário, permitindo que ele continue enviando uma solicitação grande com segurança.
101. Mudança de Protocolos . O servidor informa ao cliente que está alterando as regras do jogo, por exemplo, migrando de HTTP para o mais seguro HTTPS. Nesse caso, o cabeçalho "Upgrade" é usado para a mudança de protocolo.
102 Processando . Este código é como uma mensagem de que o servidor aceitou a solicitação, mas ainda está ocupado com uma operação complexa.
103. Indícios Antecipados . Aqui, o servidor envia vários cabeçalhos indicativos ao cliente antes da resposta principal, alertando sobre algo que pode ser relevante em um futuro próximo.
Código 2xx (bem-sucedido)
Códigos de erro HTTP no grupo 2xx indicam uma solicitação bem-sucedida do servidor. Eles agem essencialmente como uma “luz verde” no escopo das comunicações da web, confirmando que tudo está indo conforme o planejado e foi concluído com sucesso.
200 OK . Este status é usado quando o servidor processa uma solicitação pelo método GET sem problemas e retorna os dados solicitados como resposta. O cabeçalho "Content-Type" informa o tipo de conteúdo na resposta. Ele apenas informa ao cliente que a solicitação foi bem-sucedida.
201 Criado . Aqui o servidor anuncia a criação de um novo recurso.
202 Aceito . O servidor informa ao usuário que a solicitação foi aceita, mas levará algum tempo para responder.
203 Informação Não Oficial . Este código fornece ao cliente dados que podem não ser oficiais, mas podem ser usados para comparação.
204 Sem conteúdo . O servidor processou a solicitação, mas não está retornando nenhum conteúdo adicional.
205 Redefinir conteúdo . Aqui, o cliente é instruído a redefinir a visualização ou os dados atuais após o envio.
206 Conteúdo Parcial . Este caso indica que a resposta contém apenas parte do conteúdo solicitado. O cabeçalho "Content-Range" indica o intervalo de conteúdo parcial.
207 Multi-Status. O servidor concluiu com sucesso uma solicitação de múltiplas operações do cliente e a resposta contém informações sobre o status de cada uma das operações.
226 IM Usado . Este código indica que o servidor usou o método de Metadados Incrementais (IM) e respondeu passando apenas as partes modificadas do recurso para o cliente.
Códigos 3xx (redirecionamentos)
Os códigos 3xx no protocolo HTTP são como ponteiros que guiam o usuário para um novo local de recurso. Eles informam ao cliente que etapas de acompanhamento devem ser tomadas para obter o conteúdo solicitado ou para ser redirecionado para outro recurso. Vamos mergulhar nos detalhes de cada um deles:
300 Múltiplas Escolhas . O cliente recebe um sinal de que existem várias localizações possíveis para o recurso e tem a opção de escolher uma delas. Nas circunstâncias atuais, o cabeçalho "Localização" pode indicar opções alternativas para o recurso.
301 Movido Permanentemente. O servidor informa ao usuário que o recurso foi movido permanentemente para outro local.
302 Found . Este código HTTP é semelhante a um redirecionamento temporário. O servidor informa ao consumidor que o recurso está temporariamente disponível em um URL diferente. O cabeçalho "Location" aponta para o novo URL do redirecionamento temporário.
303 Ver Outros . O cliente é informado de que o recurso está disponível em um URL diferente e deve fazer uma solicitação GET para esse novo endereço.
304 Não Modificado . Este status informa ao cliente que o recurso permaneceu inalterado desde a última solicitação e não precisa ser baixado novamente. Ao fazer uma solicitação, o cabeçalho "If-Modified-Since" é usado para verificar se o recurso foi modificado.
305 Usar Proxy. Como resposta, o servidor informa que deve usar o proxy especificado para acessar o recurso solicitado.
306 (reservado) — O código foi reservado, mas na verdade não é usado.
307 Redirecionamento Temporário . Este código é semelhante ao 302 Encontrado, mas exige que o cliente permaneça no método de requisição usado na requisição original.
308 Redirecionamento Permanente . Indica que o recurso foi movido permanentemente para um novo URI e o cliente deve usar o novo URI para todas as solicitações futuras.
Erro HTTP 4xx (erros do cliente)
Códigos de erro HTTP 4xx indicam erros de cliente. Isso significa que o problema está no lado do usuário, como o navegador da web ou o aplicativo.
Erro 400 (Solicitação Inválida) . O servidor não pôde processar a solicitação devido a erros de sintaxe, dados inválidos ou outros erros do lado do cliente.
Erro 401 Não autorizado. O servidor não pode processar a solicitação devido a erros de sintaxe, dados inválidos ou outros erros do lado do cliente.
402 Pagamento Necessário . O código não está ativo no momento e está reservado para uso futuro. Ele pode indicar a necessidade de pagamento para acessar o recurso futuramente.
Erro HTTP 403 Proibido. O cliente não possui direitos suficientes para acessar o recurso solicitado.
Erro 404: Não encontrado. O recurso solicitado não existe no servidor. Este é um dos erros de usuário mais comuns.
Erro 405: Método não permitido . O servidor não suporta o método de requisição especificado para este recurso. O cabeçalho "Allow" indica os métodos permitidos para o recurso. Com este código,
406 Não Aceitável. O servidor não pode fornecer dados em um formato que possa ser aceito pelo cliente.
407 Autenticação de proxy necessária . A autenticação no servidor proxy é necessária para acessar o recurso solicitado.
408 Tempo limite da solicitação . O servidor estava aguardando uma solicitação do cliente, mas o tempo limite foi atingido. O cabeçalho "Retry-After" pode indicar o tempo após o qual a solicitação poderá ser repetida.
409 Conflito. A solicitação não pode ser concluída devido a um conflito com o estado atual do recurso.
410 Ausente . O recurso solicitado existia anteriormente, mas foi excluído e não se espera que seja restaurado.
411 Comprimento Necessário . O servidor exige que você especifique o comprimento do conteúdo na solicitação; a ausência dessa informação é considerada um erro.
412 Pré-condição falhou . Uma pré-condição na solicitação não foi atendida, o que impede sua execução.
413 Carga útil muito grande . O tamanho dos dados da solicitação excede os limites do servidor.
414 URI Muito Longa . O comprimento da URI na solicitação excede os limites aceitáveis.
415 Tipo de mídia não suportado . O servidor não pode processar o tipo de dados fornecido na solicitação.
416 Intervalo não atendido . Erro HTTP em que o intervalo solicitado não corresponde aos dados atuais do servidor.
417 Expectativa Falhou . A condição esperada no cabeçalho "Expect" não foi atendida.
418 Sou um bule de chá . Este código é uma brincadeira e não implica nenhuma ação real para o usuário ou servidor, nem representa um erro propriamente dito. Ele indica que o servidor é um bule de chá e não é capaz de fazer café.
421 Solicitação Incorreta . O servidor não processou a solicitação devido a um erro na solicitação ou na configuração do servidor.
422 Entidade não processável . O servidor entende a solicitação, mas não a processa devido a erros nos dados.
423 Bloqueado. O recurso está bloqueado e não pode ser processado.
424 Falha na Dependência . A solicitação depende de outra solicitação não executada.
425 Muito cedo. O servidor não está pronto para processar a solicitação devido ao seu atraso.
426 Atualização necessária . O servidor requer o uso de um protocolo mais avançado para processar a solicitação.
428 Pré-condição necessária . O servidor exige que certas pré-condições sejam especificadas na solicitação.
429 Muitas solicitações . O cliente enviou muitas solicitações em um curto período de tempo, excedendo os limites do servidor.
431 Campos do cabeçalho da solicitação muito grandes . Os cabeçalhos da solicitação excedem o tamanho máximo permitido.
449 Tentar novamente. Indica que a solicitação não pode ser executada pelo servidor atual, mas pode ser processada com sucesso por outro servidor, e o cliente deve tentar novamente a solicitação com um novo URI.
451 Indisponível por motivos legais . O recurso está indisponível por motivos legais.
499 Solicitação Fechada pelo Cliente . O servidor recebeu a solicitação, mas a conexão foi fechada pelo cliente antes da conclusão do processamento.
Erro HTTP 5xx (erros do servidor)
Os códigos de erro HTTP 5xx indicam problemas no servidor. Esses códigos indicam problemas que ocorreram no lado do servidor, tornando o servidor incapaz de processar a solicitação do usuário de forma correta. Vamos dar uma olhada mais de perto neles:
Erro HTTP 500: Erro interno do servidor . O servidor encontrou circunstâncias inesperadas que o impediram de concluir a solicitação. O cabeçalho "Server" pode indicar o servidor no qual o erro ocorreu.
501 Não Implementado . O servidor não suporta a funcionalidade necessária para processar a solicitação do cliente. O cabeçalho "Via" pode indicar o servidor proxy através do qual o erro ocorreu.
502 Bad Gateway . Este código significa que o servidor que atua como proxy recebeu uma resposta incorreta de outro servidor.
Erro HTTP 503: Serviço indisponível . O servidor está temporariamente impossibilitado de processar solicitações.
Erro 504 Gateway Timeout . O servidor que atua como proxy não recebeu uma resposta em tempo hábil de outro servidor.
505 Versão HTTP não suportada . O servidor não suporta a versão do protocolo HTTP especificada na solicitação. Como alternativa, o cabeçalho "Upgrade" pode indicar os protocolos suportados.
506 Variant Also Negotiates . Este status não é usado no HTTP/1.1; no entanto, se o servidor detectar uma configuração interna que resulte em ambiguidade na negociação de conteúdo, ele poderá usar esta resposta.
507 Armazenamento insuficiente . O servidor não pode atender à solicitação devido à falta de espaço de armazenamento.
Erro 508: Loop detectado . O servidor detectou um loop durante o processamento da solicitação e se recusa a concluí-la para evitar um loop infinito.
509 Limite de largura de banda excedido . O erro ocorre quando a largura de banda do servidor é excedida devido ao alto volume de solicitações ou tráfego.
510 Não prorrogado . O cliente deve transferir extensões adicionais para dar continuidade à solicitação.
511 Autenticação de Rede Necessária . O cliente deve autenticar-se para obter acesso à rede.
Como verificar o código de status da página
Nesta seção, consideraremos três maneiras principais de verificar o código de status da página: via linha de comando, usando um navegador da web e usando serviços online independentes. Cada um desses métodos tem suas próprias vantagens e pode ser útil em diferentes situações.
Verificando a resposta do servidor via linha de comando
A linha de comando fornece uma maneira conveniente de verificar o código de status da página sem precisar usar um navegador da web. Para esse método, você precisa abrir a linha de comando e usar o comando:
curl -I http://page-addressEste comando envia uma solicitação HEAD (somente solicitação de cabeçalhos) para a URL especificada e exibe informações, incluindo o código de status HTTP:
O exemplo acima mostra um código de resposta bem-sucedido. No caso de uma resposta que contém um código de erro, como 404 Not Found HTTP error, o resultado será semelhante:
Verificando a resposta do servidor por meio do console do navegador
O console do desenvolvedor do navegador da web fornece ferramentas para conduzir várias operações, incluindo a verificação do código de status da página. Para ver o código HTTP na resposta do servidor, você precisa abrir o console do desenvolvedor (Ctrl+Shift+K) ou (Ctrl+shift+J), dependendo do navegador usado. Em seguida, selecione a seção “rede” e carregue a página desejada:
Verificando a resposta do servidor usando ferramentas independentes
Existem diversos serviços online independentes que oferecem ferramentas para verificar o código de status de uma página da web. Esses serviços geralmente permitem obter rapidamente uma visão geral da disponibilidade e do desempenho do seu recurso. Todos eles operam com o mesmo princípio. Como exemplo, vamos considerar o recurso mais popular: httpstatus.io
Primeiro, você precisa abrir o serviço em si, depois digitar o endereço da página cuja resposta você precisa descobrir e solicitar a verificação:
O resultado será exibido na parte inferior da página:
Conclusão
Concluindo, deve ser enfatizado que entender e ser capaz de ler códigos de erro HTTP é uma habilidade essencial para qualquer pessoa envolvida em desenvolvimento web e manutenção de servidores. Conforme descobrimos cada erro e exploramos as ferramentas para detectá-los, vemos razões pelas quais é tão importante gerenciar efetivamente esses aspectos de serviços web.
