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 em que o servidor dá luz verde ao usuário, permitindo que ele continue enviando uma solicitação grande com segurança.
101 Protocolos de comutação. O servidor diz ao cliente que está mudando as regras do jogo, por exemplo, mudando de HTTP para o HTTPS mais seguro. Neste caso, o cabeçalho “Upgrade” é usado para a mudança de protocolo.
102 Processamento. Este código é como uma mensagem de que o servidor aceitou a solicitação, mas ainda está ocupado com uma operação complexa.
103 Dicas Iniciais. 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 em resposta. O cabeçalho "Content-Type" relata 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ções não autorizadas. Este código fornece ao cliente dados que podem não ser oficiais, mas podem ser usados para comparação.
204 Nenhum 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.
Conteúdo parcial 206. 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 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 escolhas múltiplas. O cliente recebe um sinal de que há vários locais possíveis para o recurso e recebe uma escolha em resposta. Em circunstâncias atuais, o cabeçalho "Location" pode indicar opções alternativas para o recurso.
301 mudou-se permanentemente. O servidor informa ao usuário que o recurso foi movido permanentemente para outro local.
302 Encontrado. Este código HTTP é semelhante a um redirecionamento temporário. O servidor informa ao consumidor que o recurso está temporariamente disponível em uma URL diferente. O cabeçalho "Location" aponta para a nova URL para o redirecionamento temporário.
303 Veja outros. O cliente é informado de que o recurso está disponível em uma 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 é utilizado.
307 Redirecionamento temporário. Este código é semelhante ao 302 Found, mas exige que o cliente permaneça no método de solicitação que foi usado na solicitação original.
308 Redirecionamento permanente. Indica que o recurso fez uma mudança permanente 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.
400 Bad Request. O servidor não pode processar a solicitação devido a erros de sintaxe, dados inválidos ou outros erros no lado do cliente.
401 Não autorizado. O servidor não pode processar a solicitação devido a erros de sintaxe, dados inválidos ou outros erros no lado do cliente.
402 Pagamento Necessário. O código não está ativo no momento e está reservado para uso futuro. Pode indicar a necessidade de pagar antes de acessar o recurso no futuro.
Erro HTTP 403 proibido. O cliente não tem direitos suficientes para acessar o recurso solicitado.
404 não encontrado. O recurso solicitado não existe no servidor. Este é um dos erros de usuário mais comuns.
Método 405 não permitido. O servidor não suporta o método de solicitação especificado durante 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 esperando para receber uma solicitação do cliente, mas atingiu o tempo limite. O cabeçalho "Retry-After" pode indicar o tempo após o qual a solicitação pode ser repetida.
409 Conflito. A solicitação não pode ser concluída devido a um conflito com o estado atual do recurso.
Longe 410. O recurso solicitado existia anteriormente, mas agora foi excluído e sua restauração não é esperada.
411 Comprimento Necessário. O servidor exige especificar o comprimento do conteúdo na solicitação; a ausência dessa informação é considerada um erro.
Falha na pré-condição 412. Uma pré-condição na solicitação não é atendida, o que impede sua execução.
413 Carga útil muito grande. O tamanho dos dados solicitados excede os limites do servidor.
URI 414 muito longo. O comprimento do 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 Faixa Não Satisfatória. Erro HTTP onde o intervalo solicitado não corresponde aos dados atuais do servidor.
417 Expectativa falhada. A condição esperada no cabeçalho "Expect" não foi atendida.
418 eu sou um bule. Este código é incluído como uma piada e não implica nenhuma ação real para o usuário ou servidor, e não é um erro completo. Ele indica que o servidor é um bule de chá e não é capaz de fazer café.
421 Solicitação mal direcionada. O servidor não processa 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 de dados.
423 Bloqueado. O recurso está bloqueado e não pode ser processado.
424 Dependência com falha. 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 à sua chegada antecipada.
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 Pedidos demais. O cliente enviou muitas solicitações em um curto espaço de tempo, excedendo os limites do servidor.
431 Campos de cabeçalho de solicitação muito grandes. Os cabeçalhos de solicitação excedem o tamanho máximo permitido.
449 Tentar novamente com. 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 a solicitação novamente com um novo URI.
451 Indisponível por motivos legais. O recurso não está disponível por motivos legais.
499 Solicitação encerrada 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 encontra circunstâncias inesperadas que impedem a conclusão da solicitação. O cabeçalho "Servidor" 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.
HTTP erro Serviço 503 Indisponível. O servidor está temporariamente impossibilitado de processar solicitações.
504 Tempo limite do gateway. O servidor, que atua como proxy, não recebeu uma resposta oportuna de outro servidor.
Versão HTTP 505 não suportada. O servidor não suporta a versão do protocolo HTTP especificada na solicitação. Como uma opção de backup, o cabeçalho "Upgrade" pode indicar protocolos suportados.
Variante 506 também negocia. Esse 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 essa resposta.
507 Armazenamento insuficiente. O servidor não pode atender à solicitação devido a espaço de armazenamento insuficiente no servidor.
508 Loop detectado. O servidor detectou um loop ao processar a 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 Estendido. O cliente deve transferir extensões adicionais para continuar a solicitação.
511 Autenticação de rede necessária. O cliente deve se autenticar 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
Há um grande número de serviços on-line independentes que fornecem ferramentas para verificar o código de status da página do site. Esses serviços geralmente permitem que você receba rapidamente uma visão geral da disponibilidade e do desempenho do seu recurso. Todos eles operam usando o mesmo princípio. Como exemplo, consideraremos 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.
