Pesquisa global não está habilitada.
Ir para o conteúdo principal
Glossário

Glossário

Código de Status HTTP de erro

por Fabiana Marques Costa - quarta-feira, 31 jul. 2024, 08:06
 

Os códigos ajudam a identificar o status das solicitações HTTP e a diagnosticar problemas que podem ocorrer durante a comunicação entre clientes e servidores na web.


Erros de Cliente (4xx)

  1. 400 Bad Request (Solicitação Inválida)

    • O que é: O servidor não pode processar a solicitação devido a uma sintaxe incorreta.
    • Como resolver:
      • Verifique a URL para erros de digitação.
      • Confirme se os parâmetros de consulta e dados no corpo da solicitação estão corretos.
      • Cheque os cabeçalhos HTTP e certifique-se de que estão corretamente formatados.
  2. 401 Unauthorized (Não Autorizado)

    • O que é: A solicitação requer autenticação do usuário.
    • Como resolver:
      • Forneça as credenciais de autenticação necessárias (nome de usuário e senha).
      • Verifique se o cliente está autorizado a acessar o recurso solicitado.
  3. 403 Forbidden (Proibido)

    • O que é: O servidor entendeu a solicitação, mas se recusa a autorizá-la.
    • Como resolver:
      • Verifique as permissões de acesso ao recurso.
      • Assegure-se de que o IP do cliente está permitido, se houver restrições de IP.
      • Confirme que as credenciais necessárias foram fornecidas corretamente.
  4. 404 Not Found (Não Encontrado)

    • O que é: O servidor não conseguiu encontrar o recurso solicitado.
    • Como resolver:
      • Verifique a URL para garantir que está correta.
      • Atualize links quebrados ou desatualizados.
      • Configure redirecionamentos para o novo local do recurso, se ele foi movido.
  5. 405 Method Not Allowed (Método Não Permitido)

    • O que é: O método da solicitação não é permitido para o recurso especificado.
    • Como resolver:
      • Verifique o método HTTP utilizado (GET, POST, PUT, DELETE) e confirme se é permitido para o recurso.
      • Consulte a documentação da API ou do servidor para métodos permitidos.
  6. 408 Request Timeout (Tempo de Solicitação Esgotado)

    • O que é: O servidor não recebeu uma solicitação completa do cliente dentro do tempo permitido.
    • Como resolver:
      • Tente enviar a solicitação novamente.
      • Verifique a velocidade da rede e a estabilidade da conexão.
  7. 429 Too Many Requests (Muitas Solicitações)

    • O que é: O cliente enviou muitas solicitações em um determinado período de tempo.
    • Como resolver:
      • Reduza a taxa de solicitações.
      • Implemente um mecanismo de espera (throttling) no cliente para respeitar os limites de taxa do servidor.

Erros de Servidor (5xx)

  1. 500 Internal Server Error (Erro Interno do Servidor)

    • O que é: Ocorreu um erro genérico no servidor que não pôde completar a solicitação.
    • Como resolver:
      • Verifique os logs do servidor para identificar a causa do erro.
      • Consulte o administrador do sistema para resolver problemas internos.
  2. 501 Not Implemented (Não Implementado)

    • O que é: O servidor não reconhece o método da solicitação ou não possui a funcionalidade para cumpri-la.
    • Como resolver:
      • Verifique se o método HTTP é suportado pelo servidor.
      • Consulte a documentação do servidor para funcionalidades suportadas.
  3. 502 Bad Gateway (Gateway Ruim)

    • O que é: O servidor, atuando como um gateway ou proxy, recebeu uma resposta inválida do servidor upstream.
    • Como resolver:
      • Verifique a comunicação entre o gateway/proxy e o servidor upstream.
      • Assegure-se de que o servidor upstream está funcionando corretamente.
  4. 503 Service Unavailable (Serviço Indisponível)

    • O que é: O servidor está temporariamente indisponível, geralmente devido a manutenção ou sobrecarga.
    • Como resolver:
      • Tente acessar novamente mais tarde.
      • Consulte o administrador do servidor sobre a disponibilidade do serviço.
  5. 504 Gateway Timeout (Tempo de Gateway Esgotado)

    • O que é: O servidor, atuando como um gateway ou proxy, não recebeu uma resposta a tempo do servidor upstream.
    • Como resolver:
      • Verifique a conexão e a comunicação entre o gateway/proxy e o servidor upstream.
      • Certifique-se de que o servidor upstream está respondendo dentro do tempo esperado.
  6. 505 HTTP Version Not Supported (Versão HTTP Não Suportada)

    • O que é: O servidor não suporta a versão do protocolo HTTP utilizada na solicitação.
    • Como resolver:
      • Atualize o cliente para usar uma versão suportada do HTTP.
      • Consulte a documentação do servidor para verificar as versões HTTP suportadas.
  7. 507 Insufficient Storage (Armazenamento Insuficiente)

    • O que é: O servidor não consegue armazenar a representação necessária para completar a solicitação.
    • Como resolver:
      • Libere espaço de armazenamento no servidor.
      • Verifique as configurações de armazenamento e considere expandi-las, se necessário.
  8. 508 Loop Detected (Loop Detectado)

    • O que é: O servidor detectou um loop infinito ao processar a solicitação.
    • Como resolver:
      • Revise a lógica do código no servidor para evitar loops infinitos.
      • Verifique se há redirecionamentos ou referências circulares na configuração do servidor.
  9. 510 Not Extended (Não Estendido)

    • O que é: A política de extensão para o recurso não foi cumprida.
    • Como resolver:
      • Consulte a documentação do servidor para verificar quais extensões são necessárias.
      • Ajuste a solicitação para cumprir com os requisitos de extensão.
  10. 511 Network Authentication Required (Autenticação de Rede Necessária)

  • O que é: O cliente precisa se autenticar para ganhar acesso à rede.
  • Como resolver:
    • Forneça as credenciais de autenticação de rede.
    • Consulte o administrador da rede para obter as credenciais necessárias.

Outros códigos de status úteis

  • 100 Continue: O servidor recebeu os cabeçalhos da solicitação e o cliente deve proceder a enviar o corpo da solicitação.
  • 101 Switching Protocols: O servidor está mudando os protocolos conforme solicitado pelo cliente.
  • 200 OK: A solicitação foi bem-sucedida e o servidor retornou os dados solicitados.
  • 201 Created: A solicitação foi bem-sucedida e um novo recurso foi criado como resultado.
  • 204 No Content: A solicitação foi bem-sucedida, mas o servidor não está retornando nenhum conteúdo.

» Glossário