Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
Apigee Edge te permite compilar de forma fácil y rápida APIs de RESTful que los desarrolladores de apps pueden consumir. Para exponer las APIs en Edge, debes compilar proxies de API que actúan como "fachadas" administradas para los servicios de backend. En este tema, se analiza la relación entre las APIs y los proxies de API en Apigee Edge.
Video: Mira este video breve para obtener una introducción a los proxies de API.
¿Qué es una API?
Una API es una interfaz que facilita que una aplicación "consuma" las funciones o los datos de otra aplicación. Mediante la definición de puntos de entrada estables y simplificados en los datos y la lógica de la aplicación, las API permiten a los desarrolladores acceder con facilidad a la lógica de aplicación que compilaron otros desarrolladores y volver a usarla. En el caso de las "API web", la lógica y los datos se exponen en la red.
Ya que las aplicaciones que consumen API son sensibles a los cambios, las API también implican un "contrato". El contrato proporciona un cierto nivel de garantía de que, con el tiempo, la API cambiará de manera predecible.
Apigee Edge te permite compilar APIs y, si ya tienes APIs, exponerlas directamente, a la vez que agregas una capa de administración y visibilidad. Si tienes servicios habilitados de HTTP, como los servicios web basados en SOA, también se pueden exponer como APIs a través de Apigee Edge.
Edge también te permite compilar APIs mediante la implementación de aplicaciones alojadas en la plataforma de servicios de API, sin ningún servicio de backend involucrado. Puedes compilar estas aplicaciones en JavaScript, Java y Node.js.
¿Qué es un proxy de API?
Para exponer las API en Apigee Edge, debe implementar proxies de API. Los proxies de API separan la API orientada a la aplicación de sus servicios de backend, lo que protege a esas aplicaciones de los cambios en el código de backend. Aunque haga cambios de backend en sus servicios, las aplicaciones seguirán llamando a la misma API sin ninguna interrupción.
En una configuración de proxy de API, hay dos tipos de extremos:
- ProxyEndpoint: Define la manera en que las apps cliente consumen tus API. Configura ProxyEndpoint para definir la URL de tu proxy de API. El extremo del proxy también determina si las apps acceden al proxy de API a través de HTTP o HTTPS. Por lo general, adjuntas políticas a ProxyEndpoint para aplicar la seguridad, las verificaciones de cuotas y otros tipos de controles de acceso y límites de frecuencia.
- TargetEndpoint: Define la forma en que el proxy de API interactúa con tus servicios de backend. Puedes configurar el extremo de destino para reenviar solicitudes al servicio de backend adecuado, incluida la definición de cualquier configuración de seguridad, protocolo HTTP o HTTPS, y otra información de conexión. Puedes adjuntar políticas al extremo de destino a fin de asegurarte de que los mensajes de respuesta tengan el formato correcto para la app que realizó la solicitud inicial.
Puedes visualizar los proxies de API como se muestra en el siguiente gráfico:
¿Cómo se crea un proxy de API?
Un proxy de API consta de un paquete de archivos de configuración XML y código (como JavaScript y Java). Apigee proporciona varias formas de crear proxies de API, incluidas las siguientes:
- Usa la IU de administración de Edge para definir un proxy de API en una interfaz gráfica de usuario (GUI). Para obtener más información, consulta Compila un proxy de API simple.
- La creación de archivos XML, junto con otros archivos compatibles, que definen tu proxy de API y, luego, su importación a Edge.
- El uso de la API de administración de Edge para crear proxies de API mediante una serie de solicitudes REST a Edge
- Implementa una aplicación de Node.js como proxy. Consulta Cómo implementar una app independiente de Node.js.
¿Qué es una política?
Edge te permite controlar el comportamiento de la API mediante policies y sin escribir código. Una política es como un módulo que implementa una función de administración limitada específica como parte del flujo de solicitud/respuesta del proxy. Las políticas están diseñadas para permitirte agregar tipos comunes de capacidades de administración a una API de forma fácil y confiable. Las políticas proporcionan funciones como la seguridad, los límites de frecuencia, la transformación y la mediación, lo que evita que tengas que codificar y mantener esta funcionalidad por tu cuenta.
Crea tu primer proxy de API
Apigee proporciona un conjunto de instructivos que puedes usar para crear tu primera API. Comienza con Compila tu primer proxy de API.
Una excelente manera de aprender sobre los proxies de API es trabajar con las muestras como se describe en Usa los proxies de API de muestra.