Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Sintoma
Erro encontrado ao fazer uma solicitação de API ativa usando o SmartDocs no portal do desenvolvedor.
Mensagens de erro
O erro comum encontrado no Portal do desenvolvedor é "Ocorreu um erro interno. Tente fazer a solicitação novamente".
Causas possíveis
Esse erro pode ocorrer quando o Portal do desenvolvedor não recebe uma resposta do back-end (proxy de smartdocs ou o endpoint real).
Diagnóstico
Ative as Ferramentas para desenvolvedores no navegador e verifique a guia de rede para identificar o erro.
Os erros comuns e as causas típicas estão listados na tabela a seguir:
Erro |
Causas típicas |
ERR_NAME_NOT_RESOLVED |
Proxy SmartDocs mal configurado ou restrições do firewall de rede |
Conteúdo misto |
Portal configurado por HTTPs, solicitação de SmartDocs por HTTP |
500 - Erro interno do servidor |
Vamos examinar cada uma dessas causas e etapas para resolver a questão.
Proxy SmartDocs mal configurado ou restrições do firewall de rede
A mensagem “ERR_NAME_NOT_RESOLVED” indica que o URL do proxy dos Smartdocs está configurado incorretamente ou que a rede de onde o portal está sendo acessado não consegue fazer uma chamada para o URL do proxy dos smartdocs devido a restrições do firewall. O proxy smartdocs precisa ser acessível pela Internet ou pela rede interna (para APIs internas).
Resolução
Verifique se o proxy do smartdocs pode ser acessado de todas as redes necessárias implantando esse proxy em um host virtual no Edge com um nome de host acessível pela Internet.
Portal configurado por HTTPS, solicitação do SmartDocs por HTTP
O erro “Conteúdo misto” indica que o proxy de documentos inteligentes está sendo chamado em HTTP a partir de uma página carregada em HTTPS.
Resolução
Exponha o proxy do Smartdocs por https para resolver o problema. Para fazer isso, implante o proxy do smartdocs e inclua um host virtual configurado para usar TLS/SSL (normalmente o host virtual "seguro").
Proxy SmartDocs que retorna uma exceção
A mensagem 500 - Erro interno do servidor pode ser causada por um problema com o proxy "smartdocs". Nesse caso, você percebe que o proxy smartdocs retorna esse erro.
Diagnóstico
Use a ferramenta Trace para diagnosticar erros com o proxy "smartdocs", conforme descrito abaixo. Para mais informações, consulte Como usar a ferramenta Trace.
- Ative o rastreamento para o proxy “smartdocs” na organização “VALIDATE” para localizar a política específica que está retornando o erro 500 interno do servidor.
- Selecione a política específica no rastreamento para identificar a causa do erro.
Resolução
Corrija o erro identificado. Se você precisar de ajuda, entre em contato com o suporte do Apigee Edge.
Os processadores de mensagens de borda não conseguem chamar o endpoint de API publicado
500 - O erro interno do servidor também pode ocorrer quando os processadores de mensagens pertencentes à organização que hospeda o proxy Smartdocs não conseguem chamar o endpoint da API.
Diagnóstico
Use a ferramenta Trace para diagnosticar erros com o proxy "smartdocs", conforme descrito abaixo. Para mais informações, consulte Como usar a ferramenta Trace.
- Ative o trace do proxy "smartdocs" na organização "VALIDATE" para localizar a política específica que está retornando o erro 500 interno do servidor.
- No trace da interface de exemplo mostrado acima, a política de JavaScript "BuildTargetAPIRequest" não executa o URL de destino.
- Consiga o URL de destino da política de JavaScript "BuildTargetAPIRequest".
- Faça uma chamada direta para o URL a partir dos nós do processador de mensagens associados à organização
"VALIDATE", conforme mostrado abaixo:
curl -v <target URL>
- Corrija qualquer erro observado.
Resolução
- Verifique se as APIs publicadas no Portal do desenvolvedor podem ser invocadas pelos processadores de mensagens associados à organização "VALIDATE" e corrija os erros encontrados.
- Se você puder executar a chamada de API diretamente do processador de mensagens, é muito provável que você também consiga executar a API pelo SmartDocs.
- Execute a chamada de API pelo SmartDocs e verifique se o problema foi corrigido.