Esta é a documentação do Apigee Edge.
Acesse
Documentação da Apigee X. informações
Sintoma
Erro encontrado ao fazer uma solicitação de API ativa usando o SmartDocs do desenvolvedor no portal do Google Cloud.
Mensagens de erro
O erro comum visto no Portal do desenvolvedor é "Ocorreu um erro interno. Tente fazer a solicitação novamente".
Causas possíveis
Este erro pode ocorrer quando o Portal do desenvolvedor não recebe uma resposta do back-end (smartdocs proxy ou o endpoint real).
Diagnóstico
Ative as Ferramentas para desenvolvedores no seu navegador e verifique a guia da rede para identificar o erro real.
Os erros mais comuns e as causas comuns estão listados na tabela a seguir:
|
Erro |
Causas comuns |
|
ERR_NAME_NOT_RESOLVED |
Proxy SmartDocs configurado ou firewall de rede configurado incorretamente restrições |
|
Conteúdo misto |
Portal configurado via HTTPs, solicitação de SmartDocs por HTTP |
|
500 - Erro interno do servidor |
Vamos examinar cada uma dessas causas e as etapas para resolver o problema.
Proxy SmartDocs ou firewall de rede configurado incorretamente restrições
A mensagem "ERR_NAME_NOT_RESOLVED" indica que o O URL do proxy do smartdocs está configurado incorretamente ou a rede da qual o portal está sendo acessado está não foi possível fazer uma chamada para o URL do proxy do smartdocs devido a restrições do firewall. Smartdocs proxy deve ser acessível pela Internet ou pela rede interna (para APIs internas).
Resolução
Implante o proxy do smartdocs para garantir que ele possa ser acessado em todas as redes necessárias o proxy do Smartdocs para um host virtual no Edge com um nome de host acessíveis pela Internet.
Portal configurado por HTTPS, solicitação do SmartDocs por HTTP
O erro Conteúdo misto indica que o proxy do Smartdocs está que está sendo chamado por HTTP de uma página carregada em HTTPS.
Resolução
Exponha o proxy do smartdocs por https para resolver o problema. É possível fazer isso implantando o proxy smartdocs para incluir um host virtual configurado para usar TLS/SSL (normalmente o host virtual “seguro”).
Proxy do SmartDocs que retorna uma exceção
A mensagem 500 - Erro interno do servidor pode ser causada por um problema no proxy “smartdocs”. Nesse caso, você nota que o proxy do Smartdocs retorna erro.
Diagnóstico
Usar a ferramenta Trace para diagnosticar erros com o proxy “smartdocs”, conforme descrito a seguir. Para mais informações, consulte Como usar a ferramenta Trace.
- Ative o trace para o proxy "smartdocs" na a organização “VALIDATE” para localizar a política específica que é retornando o erro 500 - Erro interno do servidor.
- Selecione a política específica no trace para identificar a causa do erro.
Resolução
Corrija o erro identificado. Se precisar de ajuda, entre em contato com o suporte do Apigee Edge.
Os processadores de mensagens do Edge não conseguem chamar o endpoint de API publicado
500 – Um erro interno do servidor também pode ocorrer quando os processadores de mensagens pertencentes ao organizações que hospedam o proxy Smartdocs não conseguem chamar o endpoint da API.
Diagnóstico
Usar a ferramenta Trace para diagnosticar erros com o proxy “smartdocs”, conforme descrito a seguir. Para mais informações, consulte Como usar a ferramenta Trace.
- Ative o trace para smartdocs. na organização “VALIDATE” para localizar a política específica que está retornando o erro 500 Interno do Servidor.
- No exemplo de trace da interface mostrado acima, é possível notar que a política de JavaScript "BuildTargetAPIRequest" não está executando o URL de destino.
- Encontrar o URL de destino da política do JavaScript "BuildTargetAPIRequest".
- Faz uma chamada direta para o URL a partir dos nós do processador de mensagens associados a
“VALIDATE” da organização, como mostrado abaixo:
curl -v <target URL>
- Corrija qualquer erro observado.
Resolução
- Verifique se as APIs publicadas no Portal do desenvolvedor podem ser invocadas dos processadores de mensagens associados à organização “VALIDATE” e corrigir quaisquer erros encontrados.
- Se você conseguir executar a chamada de API diretamente do processador de mensagens, é provavelmente você também deve conseguir executar a API pelo SmartDocs.
- Execute a chamada de API pelo SmartDocs e verifique se o problema foi corrigido.