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 compilación de proxies de API que actúan como "fachadas" administradas 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 ningún servicio de backend involucrado. 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 forma en que el proxy de API interactúa con tus servicios de backend. Configura TargetEndpoint para reenviar solicitudes al servicio de backend adecuado, incluida la definición de cualquier configuración de seguridad, el protocolo HTTP o HTTPS, y otra información de conexión. Puedes adjuntar políticas a 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 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 de destino, se pasan al extremo de respuesta de proxy y, luego, vuelven al cliente.

¿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 Apigee 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 Apigee.
  • El uso de la API de Apigee para crear proxies de API mediante una serie de solicitudes REST a Apigee
  • Desarrolla de forma local con Apigee en VS Code y, luego, impleméntalo como un archivo. Para obtener más información, consulta Descripción general del desarrollo local mediante Apigee.

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

Las revisiones del proxy de API proporcionan un mecanismo liviano para administrar las actualizaciones de la configuración del proxy de API a medida que iteras. 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 mientras continúas creando revisiones nuevas 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 API de prueba a 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 Compila tu primer proxy de API. Consulta también otros temas de introducción.

Más información