Información sobre las API y los proxies de API

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

Apigee Edge te permite compilar con facilidad y rapidez APIs de RESTful que los desarrolladores de apps pueden utilizar. A fin de exponer las APIs en Edge, debes compilar proxies de API que actúen como “facades” administradas para los servicios de backend. En este tema, se analiza la relación entre las API 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 mientras agregas una capa de administración y visibilidad. Si tienes servicios habilitados para 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 necesidad de un servicio de backend. Puedes compilar estas aplicaciones en JavaScript, Java y en 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:

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:

  • Usar la IU de administración perimetral para definir un proxy de API en una interfaz gráfica de usuario (GUI) Para obtener más información, consulta Cómo compilar un proxy de API simple.
  • Crear archivos en formato XML, junto con cualquier otro archivo complementario, que definan tu proxy de API y, luego, los importen a Edge.
  • Usar la API de Edge Management para crear los proxies de API mediante una serie de solicitudes de REST a Edge.
  • Implementar una aplicación de Node.js como proxy Consulta Implementa una app de Node.js independiente.

¿Qué es una política?

Edge te permite controlar el comportamiento de la API sin escribir ningún código mediante políticas. 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 los ejemplos, tal como se describe en Cómo usar los proxies de API de muestra.

Más información