Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
Síntoma
Se encontró un error cuando se realizaba 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 enviar la solicitud”.
Causas posibles
Este error puede ocurrir cuando el portal para desarrolladores no obtiene una respuesta del backend (proxy de smartdocs o del extremo real).
Diagnóstico
Habilita las "Herramientas para desarrolladores" en tu navegador y revisa la pestaña de red a fin de identificar el error real.
En la siguiente tabla, se enumeran los errores comunes y sus causas típicas:
|
Error |
Causas típicas |
|
ERR_NAME_NOT_RESOLVED |
El proxy de SmartDocs está mal configurado o las restricciones de firewall de la red |
|
Contenido mixto |
Portal configurado a través de HTTP, solicitud de SmartDocs a través de HTTP |
|
500 - Error interno del servidor |
Veamos cada una de estas causas una por una y los pasos para resolver el problema.
Configuración incorrecta del proxy de SmartDocs o restricciones de firewall de 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 llamadas a la URL del proxy de Smartdocs debido a restricciones del firewall. Se debe poder acceder al proxy de smartdocs desde Internet o desde la red interna (para las APIs internas).
Resolución
Implementa el proxy de Smartdocs en un host virtual en Edge con un nombre de host accesible desde Internet para asegurarte de que se pueda acceder al proxy de Smartdocs desde todas las redes necesarias.
Portal configurado a través de HTTPS, solicitud de SmartDocs mediante HTTP
El error "Mixed Content" indica que se llama al proxy de smartdocs a través de HTTP desde una página cargada en HTTPS.
Resolución
Expón el proxy de smartdocs sobre https para resolver el problema. Puedes hacerlo implementando el proxy de Smartdocs para incluir un host virtual configurado para usar TLS/SSL (por lo general, el host virtual “seguro”).
Proxy de SmartDocs que muestra una excepción
El mensaje 500 - Internal Server Error puede deberse a un problema con el proxy “smartdocs”. En este caso, observas 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 de seguimiento.
- Habilita el seguimiento para el proxy “smartdocs” en la organización “VALIDATE” a fin de ubicar la política específica que muestra el error 500 interno del servidor.
- Selecciona la política específica en el seguimiento para identificar la causa del error.
Resolución
Corrige el error identificado. Si necesitas ayuda, comunícate con el equipo de asistencia de Apigee Edge.
Los procesadores de mensajes perimetrales no pueden llamar al extremo de API publicado
500: Error interno del servidor también puede ocurrir cuando los procesadores de mensajes que pertenecen a la organización que aloja el proxy de Smartdocs no pueden llamar al extremo de la 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 de seguimiento.
- Habilita trace para el proxy “smartdocs” en la organización “VALIDATE” a fin de localizar la política específica que muestra el error 500 Internal Server Error.
- En el ejemplo de seguimiento de IU 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 del procesador de mensajes asociados con la organización “VALIDATE”, como se muestra a continuación:
curl -v <target URL>
- Corrige cualquier error observado.
Resolución
- Asegúrate de que las APIs publicadas en el Portal para desarrolladores se puedan invocar desde los procesadores de mensajes asociados con la organización “VALIDATE” y corrige cualquier error que se encuentre.
- Si puedes ejecutar la llamada a la API directamente desde Message Processor, es muy probable que también puedas ejecutar la API con SmartDocs.
- Ejecuta la llamada a la API a través de SmartDocs y verifica si se solucionó el problema.