Códigos HTTP de Erro do Cliente: Uma Análise Detalhada
Client Error [400 – 499]
Os códigos de status HTTP na faixa de 400 a 499 são conhecidos como códigos de erro do cliente. Eles são retornados pelo servidor quando há um problema com a requisição feita pelo cliente, indicando que a requisição não pôde ser completada devido a algum erro do lado do cliente. Vamos examinar cada um desses códigos e entender o que eles representam.
400 – Bad Request
Esse código é retornado quando o servidor não consegue entender a requisição feita pelo cliente devido a sintaxe inválida, estrutura malformada ou outros erros semelhantes.
401 – Unauthorized
O código 401 indica que o cliente não tem permissão para acessar o recurso solicitado. Isso geralmente ocorre quando o cliente não forneceu credenciais de autenticação válidas.
402 Payment Required
Embora este código esteja definido na especificação HTTP/1.1, ele não é comumente utilizado e sua interpretação pode variar. Em teoria, ele sugere que o acesso ao recurso requer pagamento, mas sua implementação prática é rara.
403 – Forbidden
Quando o servidor retorna o código 403, ele está indicando que o cliente não tem permissão para acessar o recurso solicitado, independentemente de fornecer ou não credenciais de autenticação.
404 – Not Found
Este é um dos códigos de erro mais comuns. Ele indica que o recurso solicitado não pôde ser encontrado no servidor. Isso pode ser devido a uma URL incorreta, um recurso removido ou outras razões semelhantes.
405 Method Not Allowed
Quando o cliente tenta usar um método HTTP que não é permitido para o recurso solicitado, o servidor retorna o código 405. Por exemplo, tentar fazer uma requisição POST para uma URL que só aceita requisições GET.
406 Not Acceptable
Esse código é retornado quando o servidor não consegue fornecer uma representação que atenda aos critérios de negociação de conteúdo do cliente, geralmente expressos nos cabeçalhos Accept da requisição.
407 Proxy Authentication Required
Semelhante ao 401, mas especificamente para situações em que o cliente precisa se autenticar com um proxy antes de acessar o recurso solicitado.
408 Request Timeout
Indica que o servidor encerrou a conexão porque a requisição do cliente demorou muito para ser concluída. Isso pode acontecer se o servidor estiver sobrecarregado ou se a conexão com a internet do cliente for instável.
409 – Conflict
Este código é retornado quando a requisição do cliente entra em conflito com o estado atual do servidor, como tentar atualizar um recurso que foi modificado desde que o cliente o acessou pela última vez.
410 Gone
Indica que o recurso solicitado não está mais disponível no servidor e não haverá redirecionamento para uma nova localização. É como se o recurso tivesse desaparecido permanentemente.
411 Length Required
Esse código é retornado quando o servidor espera que o cliente especifique o tamanho do conteúdo na requisição, mas o cliente não fornece esse valor.
412 Precondition Failed
Indica que uma das condições especificadas na requisição não foi atendida antes que o servidor pudesse processar a requisição.
413 Payload Too Large
O servidor retorna este código quando a requisição do cliente é rejeitada porque o corpo da requisição é maior do que o servidor está disposto a processar.
414 Request-URI Too Long
Indica que a URI (Uniform Resource Identifier) da requisição é muito longa para o servidor processar.
415 Unsupported Media Type
Indica que o servidor não suporta o tipo de mídia especificado na requisição do cliente.
416 Requested Range Not Satisfiable
Retornado quando o servidor não pode satisfazer a faixa de bytes especificada na requisição do cliente.
417 Expectation Failed
Indica que uma ou mais expectativas declaradas pelo cliente na requisição não podem ser atendidas pelo servidor.
418 I’m a teapot
Uma resposta de brincadeira e não oficial, indicando que o servidor é um bule de chá e, portanto, não pode processar a requisição.
421 Misdirected Request
Indica que a requisição foi direcionada incorretamente e que o cliente deve repetir a requisição para o endereço correto.
422 Unprocessable Entity
Retornado quando o servidor entende o conteúdo da requisição, mas não pode processá-lo devido a um erro semântico.
423 Locked
Indica que o recurso solicitado está bloqueado e não pode ser acessado.
424 Failed Dependency
Indica que a requisição falhou devido a uma falha em uma dependência necessária.
426 Upgrade Required
O servidor exige que o cliente atualize para uma versão mais recente do protocolo usado para acessar o recurso.
428 Precondition Required
Indica que a requisição está faltando uma ou mais condições necessárias.
429 Too Many Requests
Retornado quando o cliente fez muitas requisições dentro de um determinado período de tempo.
431 Request Header Fields Too Large
Indica que os cabeçalhos da requisição são muito grandes para serem processados pelo servidor.
444 Connection Closed Without Response
O servidor fecha a conexão sem enviar uma resposta.
451 Unavailable For Legal Reasons
Indica que o servidor está negando o acesso ao recurso devido a restrições legais.
499 Client Closed Request
O cliente fechou a conexão antes de o servidor ter concluído a resposta.
Esses códigos de erro do cliente ajudam a identificar e diagnosticar problemas relacionados às requisições feitas pelos clientes. Eles fornecem informações úteis sobre o motivo pelo qual uma requisição falhou, permitindo que os desenvolvedores corrijam e melhorem suas aplicações web.
Share this content: