Comprender las API y los proxies de APIs

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Apigee te permite crear APIs RESTful de forma fácil y rápida que los desarrolladores de aplicaciones pueden consumir. Para exponer APIs en Apigee, debes crear proxies de API que actúen como "fachadas" gestionadas para los servicios de backend. En este tema se explica la relación entre las APIs y los proxies de APIs en Apigee.

Vídeo: echa un vistazo a este breve vídeo para obtener una introducción a los proxies de APIs.

¿Qué es una API?

Una API es una interfaz que facilita que una aplicación consuma funciones o datos de otra aplicación. Al definir puntos de entrada estables y simplificados para la lógica y los datos de las aplicaciones, las APIs permiten a los desarrolladores acceder y reutilizar fácilmente la lógica de las aplicaciones creada por otros desarrolladores. En el caso de las APIs web, la lógica y los datos se exponen a través de la red.

Como las aplicaciones que consumen APIs son sensibles a los cambios, las APIs también implican un contrato. El contrato ofrece cierto nivel de garantía de que, con el tiempo, la API cambiará de forma predecible.

Apigee te permite crear APIs y, si ya tienes APIs, exponerlas directamente, al tiempo que añades una capa de gestión y visibilidad. Si tienes servicios con HTTP habilitado, como los servicios web basados en SOA, también se pueden exponer como APIs a través de Apigee.

Apigee también te permite crear APIs implementando aplicaciones alojadas en la plataforma API Services, sin necesidad de usar ningún servicio de backend. Puedes crear estas aplicaciones en JavaScript y Java.

¿Qué es un proxy de API?

En Apigee, las APIs se exponen mediante la implementación de proxies de APIs. Los proxies de APIs desvinculan la API orientada a aplicaciones de los servicios de backend y protegen esas aplicaciones frente a cambios en el código del backend. Cuando hagas cambios en el backend de tus servicios, las aplicaciones seguirán llamando a la misma API sin interrupciones.

En una configuración de proxy de API, hay dos tipos de endpoints:

  • ProxyEndpoint: define la forma en que las aplicaciones cliente consumen tus APIs. Configura el ProxyEndpoint para definir la URL de tu proxy de API. El endpoint del proxy también determina si las aplicaciones acceden al proxy de la API a través de HTTP o HTTPS. Normalmente, se adjuntan políticas al ProxyEndpoint para aplicar medidas de seguridad, comprobaciones de cuota y otros tipos de control de acceso y limitación de la frecuencia.
  • TargetEndpoint: define la forma en que el proxy de API interactúa con tus servicios de backend. Configuras TargetEndpoint para que reenvíe las solicitudes al servicio de backend adecuado, lo que incluye definir los ajustes de seguridad, el protocolo HTTP o HTTPS y otra información de conexión. Puedes adjuntar políticas al elemento TargetEndpoint para asegurarte de que los mensajes de respuesta tengan el formato adecuado para la aplicación que ha enviado la solicitud inicial.

Puedes visualizar los proxies de API como se muestra en el siguiente gráfico:

Las solicitudes HTTP entran por el endpoint de solicitud de proxy, se transfieren al endpoint de solicitud de destino y, a continuación, se envían a los servicios de backend. Las respuestas HTTP entran por el endpoint de respuesta de destino, se
    envían al endpoint de respuesta del proxy y, a continuación, vuelven al cliente.

Tipos de proxies de API

Apigee admite dos tipos de proxies:

  • Los proxies estándar solo incluyen políticas estándar. Los proxies estándar son adecuados para soluciones de API ligeras y no se pueden incluir en productos de API.
  • Los proxies extensibles incluyen al menos una política extensible o un hook de flujo. Los proxies extensibles pueden incluir muchas más funciones que los proxies estándar.

¿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 ofrece varias formas de crear proxies de API, entre las que se incluyen las siguientes:

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

Las revisiones de proxies de API proporcionan un mecanismo ligero para gestionar las actualizaciones de la configuración del proxy de API a medida que iteras. Las revisiones se numeran secuencialmente, lo que te permite deshacer un cambio desplegando una revisión anterior de tu proxy de API. Las revisiones te permiten desplegar un proxy de API en un entorno de producción mientras sigues creando nuevas revisiones de ese proxy de API en un entorno de pruebas. Cuando lo tengas todo listo, puedes promocionar la revisión superior de tu proxy de API de prueba a producción.

¿Qué es una política?

Apigee te permite controlar el comportamiento de las APIs sin escribir código mediante el uso de políticas. Una política es como un módulo que implementa una función de gestión específica y limitada como parte del flujo de solicitud o respuesta del proxy. Las políticas están diseñadas para que puedas añadir tipos comunes de funciones de gestión a una API de forma fácil y fiable. Las políticas proporcionan funciones como seguridad, limitación de frecuencia, transformación y mediación, lo que te ahorra tener que codificar y mantener estas funciones por tu cuenta.

Crear tu primer proxy de APIs

Apigee ofrece una serie de tutoriales que puedes usar para crear tu primera API. Empieza con el artículo Crea tu primer proxy de APIs. Consulta también otros artículos de la serie Empezar.

Más información