Esta página se aplica a Apigee y Apigee Hybrid.
Consulta la documentación de
Apigee Edge.
Puedes añadir código en lenguajes procedimentales, como JavaScript, Java y Python, y, a continuación, llamar a ese código desde otras partes de un proxy de API. La compatibilidad con el código de procedimiento se ha diseñado para que te resulte más fácil implementar la gestión compleja de variables de flujo, errores y cuerpos de solicitud y respuesta.
Con el código de procedimiento, puedes hacer lo siguiente:
- Crear o manipular valores de cuerpo complejos, como valores de solicitud y respuesta.
- Reescribir URLs, por ejemplo, para enmascarar una URL de endpoint de destino.
- Añadir otra lógica que no esté disponible con las políticas incluidas.
Cómo funciona
Usa una política específica del idioma para hacer llamadas desde un flujo de proxy a tu código incluido. Apigee incluye una política independiente para cada uno de los lenguajes admitidos: política JavaScript, política JavaCallout y política PythonScript.
A continuación, se describe de forma general una de las formas en las que funciona. Consulta las referencias de la política para obtener más información.
- En otro archivo, escribe el código que vas a usar.
- En tu código, coloca el resultado del procesamiento del código en una variable de flujo de Apigee.
Recuperarás el valor de la variable en otra parte de tu proxy de API. Para obtener más información sobre las variables de flujo, consulta el artículo Gestionar el estado del proxy con variables de flujo.
- Añade tu archivo (o JAR) como archivo de recursos a tu proxy de API.
Para obtener más información sobre los archivos de recursos, consulta Archivos de recursos.
- Añade la política correspondiente al idioma que estés usando.
Configura la política para hacer una llamada a tu código desde el lugar que quieras del flujo de tu proxy de API.
- Usa una política para obtener el valor del código de la variable de flujo.
Limitaciones
El modelo de seguridad de Apigee no permite llamadas al sistema, como E/S de red, lecturas o escrituras del sistema de archivos, información del usuario actual, lista de procesos y uso de CPU o memoria. Aunque algunas de estas llamadas pueden funcionar, no se admiten y pueden inhabilitarse en cualquier momento. Para que sea compatible con versiones posteriores, debes evitar hacer estas llamadas en tu código.
Puede haber otras limitaciones para cada idioma admitido, tal como se describe en la referencia de la política correspondiente.
Idiomas disponibles
JavaScript
La compatibilidad con JavaScript incluye un modelo de objetos completo para gestionar variables y valores específicos de un proxy de API. Para obtener más información, consulta Modelo de objetos de JavaScript.
Para consultar información de referencia y ejemplos sobre las políticas, consulta la política de JavaScript.
Java
Usa la política JavaCalloutpara hacer llamadas al código Java desde el flujo de tu proxy. En el tema de referencia de las políticas se incluyen ejemplos.
Python
Usa la política Secuencia de comandos de Pythonpara llamar al código de Python.