Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
Síntoma
Se produjo un error cuando se realizó una solicitud a la API en vivo con SmartDocs desde el portal para desarrolladores.
Mensajes de error
El error común que se ve en el portal para desarrolladores es “Se produjo un error interno. Vuelve a intentar tu solicitud”.
Causas posibles
Este error puede ocurrir cuando el portal para desarrolladores no puede obtener una respuesta del backend (proxy de SmartDocs o el extremo real).
Diagnóstico
Habilita “Herramientas para desarrolladores” en tu navegador y revisa la pestaña de red para identificar el error real.
En la siguiente tabla, se enumeran los errores comunes y sus causas típicas:
|
Error |
Causa(s) típica(s) |
|
ERR_NAME_NOT_RESOLVED |
Proxy de SmartDocs mal configurado o restricciones de firewall de la red |
|
Contenido mixto |
Portal configurado a través de HTTPS, solicitud de SmartDocs a través de HTTP |
|
500: Error interno del servidor |
Analicemos cada una de estas causas y los pasos para resolver el problema.
Proxy de SmartDocs mal configurado o restricciones de firewall de la red
El mensaje “ERR_NAME_NOT_RESOLVED” indica que la URL del proxy de SmartDocs está mal configurada o que la red desde la que se accede al portal no puede realizar una llamada a la URL del proxy de SmartDocs debido a las restricciones del firewall. Se debe poder acceder al proxy de SmartDocs desde Internet o desde la red interna (para las APIs internas).
Solución
Para asegurarte de que se pueda acceder al proxy de SmartDocs desde todas las redes requeridas, implementando el proxy de SmartDocs en un host virtual en Edge con un nombre de host al que se pueda acceder desde Internet.
Portal configurado a través de HTTPS, solicitud de SmartDocs a través de HTTP
El error “Contenido mixto” indica que se llama al proxy de SmartDocs a través de HTTP desde una página cargada a través de HTTPS.
Solución
Expón el proxy de SmartDocs a través de HTTPS para resolver el problema. Para ello, implementa el proxy de SmartDocs para incluir un host virtual configurado para usar TLS/SSL (por lo general, el host virtual “seguro”).
El proxy de SmartDocs muestra una excepción
El mensaje 500: Error interno del servidor puede deberse a un problema con el proxy “smartdocs”. En este caso, notarás que el proxy de SmartDocs muestra este error.
Diagnóstico
Usa la herramienta Trace para diagnosticar errores con el proxy “smartdocs”, como se describe a continuación. Para obtener más información, consulta Usa la herramienta Trace.
- Habilita el seguimiento para el proxy “smartdocs” en la organización “VALIDATE” para ubicar la política específica que muestra el error interno del servidor 500.
- Selecciona la política específica en el seguimiento para identificar la causa del error.
Solución
Corrige el error identificado. Si necesitas ayuda, comunícate con el equipo de asistencia de Apigee Edge.
Los procesadores de mensajes de Edge no pueden llamar al extremo de API publicado
También puede producirse un error interno del servidor 500 cuando los Message Processors que pertenecen a la organización que aloja el proxy de SmartDocs no pueden llamar al endpoint de API.
Diagnóstico
Usa la herramienta Trace para diagnosticar errores con el proxy “smartdocs”, como se describe a continuación. Para obtener más información, consulta Usa la herramienta Trace.
- Habilita el seguimiento para el proxy “smartdocs” en la organización “VALIDATE” para ubicar la política específica que muestra el error interno del servidor 500.
- En el seguimiento de la IU de muestra que se muestra arriba, se observa que la política de JavaScript “BuildTargetAPIRequest” no puede ejecutar la URL de destino.
- Obtén la URL de destino de la política de JavaScript “BuildTargetAPIRequest”.
- Realiza una llamada directa a la URL desde los nodos de Message Processor asociados con
“VALIDATE” org, como se muestra a continuación:
curl -v <target URL>
- Corrige cualquier error observado.
Solución
- Asegúrate de que se puedan invocar las APIs publicadas en el portal para desarrolladores desde los procesadores de mensajes asociados con la organización “VALIDATE” y corrige cualquier error que se produzca.
- Si puedes ejecutar la llamada a la API directamente desde el Message Processor, es muy probable que también puedas ejecutar la API a través de SmartDocs.
- Ejecuta la llamada a la API a través de SmartDocs y verifica si se solucionó el problema.