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:
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:
- Usar la interfaz de usuario de Apigee para definir un proxy de API en una interfaz gráfica de usuario (GUI). Para obtener más información, consulta Desarrollar un proxy de APIs sencillo.
- Crear archivos XML, junto con otros archivos complementarios, que definan tu proxy de API y, a continuación, importarlos a Apigee.
- Usando la API de Apigee para crear tus proxies de API haciendo una serie de solicitudes REST a Apigee.
- Desarrolla localmente con Apigee en VS Code y despliega el resultado como un archivo. Para obtener más información, consulta Información general sobre el desarrollo local con Apigee.
¿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
- Referencia de configuración de proxies de APIs
- Ciclo de vida del desarrollo de APIs
- Puntos clave del desarrollo de proxies de APIs