Esta página se aplica a Apigee y Apigee híbrido .
Ver la documentación de Apigee Edge .
Este tema enumera algunas características básicas de los servidores proxy API, junto con enlaces a más información.
Las API son puntos de entrada para que una aplicación utilice las capacidades de otra. Se implementan proxies de API para crearlas.
En Apigee, se implementan proxies de API configurando su lógica como una secuencia de pasos que se ejecutan en respuesta a una solicitud del código del cliente. Se expone un proxy de API a los clientes definiendo puntos finales que incluyen una URL con rutas de recursos, un verbo HTTP, requisitos del cuerpo, etc.
Aunque se llama proxy API, desde la perspectiva del código del cliente, es la API .
Para obtener una descripción general de los proxies de API, consulte Descripción de las API y los proxies de API .
Organiza la secuencia de lógica del proxy API usando flujos
En cualquier aplicación, los datos fluyen a través de ella guiados por la lógica de condiciones. En Apigee, la ruta de procesamiento se compone de flujos. Un flujo es una secuencia de etapas (o "pasos") que conforman la ruta de procesamiento de un proxy de API. Los flujos son la forma en que Apigee proporciona espacios para aplicar lógica y comportamiento en puntos específicos, desde el cliente hasta el recurso de backend y, posteriormente, de vuelta al cliente.
Para obtener más información sobre los flujos, consulte Controlar cómo se ejecuta un proxy con flujos
Se accede a los datos de estado a través de variables de flujo creadas por servidores proxy API
Un proxy de API tiene acceso a variables que representan el estado de ejecución. Puedes acceder a estas variables desde el XML que configura tus proxies y políticas de API. También puedes acceder a ellas al extender un proxy de API con un lenguaje procedural, como Java, JavaScript o Python.
Apigee almacena estas variables. Algunas existen por defecto, generalmente porque son comunes a las funciones de los proxies de API (por ejemplo, porque forman parte de una solicitud HTTP). También puedes crear tus propias variables para cumplir con un requisito lógico.
Para obtener más información sobre las variables, consulte Administrar el estado del proxy con variables de flujo .
Puede hacer que los servidores proxy de API se ejecuten condicionalmente
Al igual que en la mayoría de los lenguajes de programación, en los proxies de API se puede ejecutar código condicionalmente. Las condiciones suelen basarse en el estado del proxy de API, al que se puede acceder mediante variables de flujo. Por ejemplo, se puede tener una condición que verifique el agente de usuario y procese la solicitud en consecuencia.
Para obtener más información sobre la ejecución condicional, consulte Condiciones con variables de flujo .
Implementa la mayor parte de la lógica en un proxy API mediante políticas
La mayor parte de la lógica que se añade a un proxy de API se empaqueta en forma de políticas. Una política es un componente de Apigee que encapsula la lógica para un área funcional, como la seguridad o la gestión del tráfico. Se configura una política con XML que define las propiedades de la lógica subyacente. Se organizan las políticas en una secuencia de "pasos" dentro de un flujo, de modo que el proxy de API ejecute la lógica en el orden óptimo para sus objetivos.
Para obtener más información sobre las políticas, consulte ¿Qué es una política?
Puede incluir conjuntos de funcionalidades reutilizables
Cuando tu proxy de API incluye lógica que se usará desde varias partes de tu código (como otros proxies de API), puedes recopilar esa lógica para llamadas desde diferentes lugares. Por ejemplo, puedes agrupar la lógica de seguridad en un flujo compartido al que llaman otros proxies de API, lo que reduce la duplicación entre ellos.
Para más información sobre flujos compartidos, consulte Flujos compartidos reutilizables . Para más información sobre el encadenamiento de proxys de API, consulte Encadenamiento de proxies de API .
Puede depurar un proxy con la herramienta Depurar
Apigee incluye una herramienta de depuración que permite examinar el flujo de ejecución del proxy de API durante la depuración y las pruebas. Esta herramienta presenta visualmente cada paso del proxy de API que se ejecuta para una solicitud. Al igual que en un depurador, en cada paso se puede ver la lista de valores de las variables que conforman el estado del proxy de API.
Para obtener más información sobre la depuración con la herramienta Depuración, consulte Herramienta Depuración .
Manejas los errores de proxy de API como fallas
Al configurar un controlador de errores, puede personalizar el error que se devuelve a un cliente de API. Los controladores de errores le permiten controlar los mensajes de error, independientemente de si el error proviene de su propio código o de un componente incluido (como una política).
Para obtener más información, consulte Manejo de fallos .