Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
Sintoma
Erro encontrado ao fazer uma solicitação de API ativa usando o SmartDocs do portal do desenvolvedor.
Mensagens de erro
O erro comum exibido 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 consegue receber uma resposta do back-end (proxy do SmartDocs ou o endpoint real).
Diagnóstico
Ative as "Ferramentas para desenvolvedores" no navegador e confira a guia "Rede" para identificar o erro real.
Os erros comuns e as causas típicas estão listados na tabela a seguir:
|
Erro |
Causa(s) típica(s) |
|
ERR_NAME_NOT_RESOLVED |
Proxy do SmartDocs mal configurado ou restrições de firewall de rede |
|
Conteúdo misto |
Portal configurado em HTTPS, solicitação do SmartDocs em HTTP |
|
500: erro interno do servidor |
Vamos analisar cada uma dessas causas e as etapas para resolver o problema.
Proxy do SmartDocs mal configurado ou restrições de firewall de rede
A mensagem ERR_NAME_NOT_RESOLVED indica que o URL do proxy do SmartDocs está mal configurado ou que a rede em que o portal está sendo acessado não consegue fazer uma chamada para o URL do proxy do SmartDocs devido a restrições de firewall. O proxy do SmartDocs precisa estar acessível na Internet ou na rede interna (para APIs internas).
Resolução
Implante o proxy do SmartDocs em um host virtual no Edge com um nome de host acessível na Internet para garantir que ele possa ser acessado de todas as redes necessárias.
Portal configurado em HTTPS, solicitação do SmartDocs em HTTP
O erro Conteúdo misto indica que o proxy do SmartDocs está sendo chamado por HTTP em uma página carregada por HTTPS.
Resolução
Exponha o proxy do SmartDocs por HTTPS para resolver o problema. Para isso, implante o proxy do SmartDocs para incluir um host virtual configurado para usar TLS/SSL (normalmente o host virtual "seguro").
O proxy do SmartDocs está retornando uma exceção
A mensagem 500: erro interno do servidor pode ser causada por um problema com o proxy "smartdocs". Nesse caso, o proxy do 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 do proxy smartdocs na organização VALIDATE para localizar a política específica que está retornando o erro interno do servidor 500.
- Selecione a política específica no rastreamento 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 publicada
O erro 500: erro interno do servidor também pode ocorrer quando os processadores de mensagens pertencentes à organização que hospeda o proxy do SmartDocs não conseguem chamar o endpoint de 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 rastreamento do proxy smartdocs na organização VALIDATE para localizar a política específica que está retornando o erro interno do servidor 500.
- No rastreamento de amostra da interface mostrado acima, é possível observar que a política de JavaScript “BuildTargetAPIRequest” não está executando o URL de destino.
- Receba o URL de destino da política de JavaScript “BuildTargetAPIRequest”.
- Faça uma chamada direta para o URL dos nós do processador de mensagens associados à organização
“VALIDATE”, conforme mostrado abaixo:
curl -v <target URL>
- Corrija qualquer erro observado.
Resolução
- Confira se as APIs publicadas no portal do desenvolvedor podem ser invocadas nos processadores de mensagens associados à organização “VALIDATE” e corrija os erros encontrados.
- Se você conseguir executar a chamada de API diretamente do processador de mensagens, é muito provável que também consiga executar a API pelo SmartDocs.
- Execute a chamada de API pelo SmartDocs e confira se o problema foi corrigido.