Información sobre las API y los proxies de API

Estás viendo la documentación de Apigee X.
Consulta la documentación de Apigee Edge.

Apigee te permite compilar de forma fácil y rápida API de RESTful que los desarrolladores de apps pueden consumir. Puedes exponer las API en Apigee mediante la creación de proxies de API que funcionen como "implementos" administrados para los servicios de backend. En este tema, se analiza la relación entre las API y los proxies de API en Apigee.

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 te permite compilar API y, si ya tienes API, 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 API a través de Apigee.

Apigee también te permite compilar API mediante la implementación de aplicaciones alojadas en la plataforma de servicios de API, sin la necesidad de un servicio de backend. Puedes compilar estas aplicaciones en JavaScript y Java.

¿Qué es un proxy de API?

Para exponer las API en Apigee Edge, debes 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 manera en que el proxy de API interactúa con tus servicios de backend. Configura el TargetEndpoint 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 TargetEndpoint 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:

Las solicitudes HTTP ingresan a través del extremo de la solicitud de proxy, se pasan al extremo de solicitud de destino y, luego, se envían a los servicios de backend. Las respuestas HTTP ingresan a través del extremo de respuesta objetivo, se pasan al extremo de respuesta del proxy y, luego, al cliente.

¿Cómo se crea un proxy de API?

Un proxy de API consiste en 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:

  • Mediante la IU de Apigee para definir un proxy de API en una interfaz de usuario gráfica (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 Apigee.
  • El uso de la API de Apigee para crear proxies de API mediante una serie de solicitudes REST a Apigee

¿Qué es una revisión del proxy de la API?

Las revisiones del proxy de API proporcionan un mecanismo básico para administrar las actualizaciones de la configuración del proxy de API a medida que repites. Las revisiones están numeradas de forma secuencial, lo que te permite revertir un cambio mediante la implementación de una revisión anterior del proxy de API. Las revisiones te permiten implementar un proxy de API en un entorno de producción y, al mismo tiempo, crear nuevas revisiones de ese proxy de API en un entorno de prueba. Cuando estés listo, puedes promover la revisión más alta del proxy de tu API de la prueba a la producción.

¿Qué es una política?

Apigee te permite controlar el comportamiento de la API mediante políticas 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 la compilación de tu primer proxy de API. Consulta también otros Temas para comenzar.

Más información