¿Qué es una pasarela API? | Cómo puede ofrecer resultados prácticos

"El término API apareció mucho antes que la World Wide Web. Más recientemente ha aparecido un nuevo término: Pasarela API. Al principio suena un poco extraño, ya que el concepto de API en sí mismo ya sugiere una pasarela".

Me alegro mucho de que lo hayas preguntado. Puede que recuerdes que el término API apareció mucho antes de la World Wide Web y es de esperar que sepas que API significa "Application Programming Interface".

Pero más recientemente ha aparecido un nuevo término: "Pasarela API". Al principio suena un poco extraño, ya que el concepto de API en sí mismo ya sugiere una pasarela. Puede que le haga preguntarse "¿qué es una pasarela API?".

En pocas palabras, una pasarela API es una herramienta de gestión que se sitúa entre un cliente y un conjunto de servicios backendCada uno con su propia API.

Por lo tanto, la pasarela de la API actúa como punto de entrada único para un grupo definido de APIs. El cliente, en este caso, será normalmente una aplicación de usuario final.

Desde un punto de vista más técnico, también se puede considerar una pasarela de API como un proxy inverso especializado que puede hacer que diferentes APIs aparezcan como si fueran una única API.

El término "puerta de enlace de la API" se utiliza a menudo en un contexto de microservicios. La granularidad de las APIs proporcionadas por los microservicios es a menudo diferente de lo que se necesita. Esto resulta simplemente del concepto de microservicios: hay varias piezas pequeñas que hacen pequeñas cosas diferentes.

Los microservicios suelen proporcionar APIs de grano fino, lo que significa que los clientes necesitan interactuar con múltiples servicios. Por ejemplo, un cliente que necesita los detalles de un producto fácilmente podría necesitar obtener datos de numerosos servicios. Por eso, una pasarela de API tiene sentido en el mundo de los microservicios.

En este contexto y dentro de una arquitectura de microservicios, de nuevo el objetivo de la pasarela API es presentar un punto de entrada único para todos los clientes, pero en este caso, esto se hace sobre todo simplificando la API presentada a los clientes.

Arquitectura de la pasarela API

En este diagrama se puede ver una pasarela API se encuentra en el borde de los sistemas. Actúa como una herramienta de gestión o middleware que media entre un cliente y un conjunto de servicios backend.

Estos los servicios de backend pueden cambiar ubicación, arquitectura e implementación (lenguaje, marco de trabajo y otros) con un impacto mínimo.

No es necesario limitarse a una vista de pasarela de API de microservicios, aunque es lo que podría llamarse la "vista clásica de una pasarela de API".

También puede ver una pasarela API de una manera más arquitectónica y verla como un patrón de diseño. Podemos decir que el patrón de la pasarela API es doble, ya que en realidad corresponde a dos patrones de diseño clásicos de la Banda de los CuatroEl adaptador y la fachada.

Como un adaptadorPermite la comunicación y la colaboración aunque las interfaces sean incompatibles.

Como un fachadaUna pasarela API encapsula la arquitectura interna de la aplicación y proporciona una API a sus clientes.

Tanto en el punto de vista de los microservicios como en el de la arquitectura, la pasarela de la API siempre tiene una función de orquestación y, al final, debe estar ahí para que las cosas funcionen sin problemas. Pero, ¿cómo pasar de los conceptos y las definiciones a los resultados?

Vamos a sumergirnos en aspectos más prácticos y ver cómo podemos obtener resultados.

Para ello utilizaremos una pasarela API específica, nuestra propia pasarela de integración llamada Connect Bridge. Piense en Connect Bridge como un punto de entrada único que "habla" SQL. Esto significa que cualquier código que se utilice (y se puede optar por cualquier lenguaje de programación) se comunicará con esta pasarela API como si fuera una base de datos, a través de las sentencias CRUD normales SELECT, INSERT, UPDATE, DELETE.

Connect Bridge tiene un "traductor" (que en realidad llamamos "conector") para cada aplicación a la que queremos llegar a través de la API. Este conector traduce efectivamente las sentencias SQL en llamadas a la API.

Al utilizar Connect Bridge, necesitarás menos código (mucho menos - la reducción puede ser de hasta 90% dependiendo del proyecto), el código será más fácil de entender y probar, y reducirás significativamente el número de errores.

Lo curioso es que cuando estés trabajando con Connect Bridge, el hecho de que utilice SQL te hará pensar que estás trabajando con la base de datos del sistema de destino, por ejemplo, la base de datos de Microsoft Exchange. Pero no te preocupes, no lo estás haciendo, y la integridad de la base de datos está a salvo - es una pasarela y siempre accede al sistema de destino a través de su API.

Paso a paso con el Connect Bridge como pasarela API

1. Código de su aplicación nueva o heredada
2. Sentencias CRUD en SQL estándar que acceden al sistema de destino como si fuera una base de datos
3. Connect Bridge traduce el SQL en llamadas a la API
4. Para cada sistema de destino, estas traducciones son gestionadas por un conector

Una nota sobre el lenguaje de programación que puedes utilizar con el Connect Bridge. Como ya he mencionado, se puede utilizar prácticamente cualquier lenguaje de programación.

Sólo tienes que asegurarte de que es compatible con ODBC, JDBC...o... Servicios web. Siempre que lo haga, estará bien.

Por ejemplo, digamos que quieres usar Java. Bien, entonces puedes generar una cadena de conexión JDBC, y ahí tienes una pasarela API Java.

¿Quieres usar Node.js? Eso también es bueno, puedes generar una cadena de conexión de servicios web y tienes tu pasarela de API de Node.js.

Podría seguir, pero creo que a estas alturas ya lo has entendido: puedes seguir utilizando tu lenguaje de programación favorito.

Connect Bridge es una herramienta de pago, con precios que varían en función del número y tipo de conectores utilizados y del número de usuarios. Para que tenga una idea general del coste de esta pasarela API, podemos decirle que los precios empiezan por 150€/mes. Para más detalles sobre los precios vaya a aquí. Le recomendamos que lo pruebe usted mismo con el prueba gratuita primero y de esta manera puede tener una idea de cuáles serán las ganancias de productividad.

En términos de retorno de la inversión, también hay que tener en cuenta que la pasarela garantiza la solución final sigue funcionando incluso cuando se actualiza el sistema de destino sin ningún cambio en el código que has escrito. Todos los problemas serán manejados por la pasarela.

Para guiarte por los primeros pasos con Connect Bridge, necesitaremos un sistema de destino de ejemplo. Elegiremos el Microsoft SharePoint para ello, pero podrían ser muchos otros.

1. Solicite una prueba gratuita.
2. Instale el Connect Bridge.
3. Maneje la configuración usando Connect Bridge Management Studio:
   • La autenticación de la pasarela API tiene dos pasos. Para conectarse al SharePoint, los usuarios deben conectarse a Connect Bridgey luego Connect Bridge necesita conectarse a SharePoint.
     • Añada una cuenta para SharePoint (Cuentas - Añadir cuenta). Necesitará sus credenciales de SharePoint.
     • O bien permite que el usuario Administrador por defecto utilice esa cuenta o crea un nuevo usuario y permite que ese usuario utilice la cuenta SharePoint.
   • o Haga clic en la opción Nueva Consulta y luego en el Navegador de Conexiones. Localice el Conector SharePoint y ábralo hasta llegar a la Conexión por defecto. Haga clic con el botón derecho del ratón sobre ella y seleccione Obtener cadena de conexión. A continuación, copie la cadena de conexión correspondiente. La necesitará para su código.

Utilice la opción de Nueva Consulta para probar una consulta que obtenga los datos que necesita de SharePoint. Aquí utilizaremos una consulta de ejemplo, pero la consulta debe ajustarse a lo que usted desea de SharePoint.

Una vez seleccionada la opción de Nueva Consulta, abra el Navegador de Conexiones.

1. Busca el Conector SharePoint y ábrelo hasta que veas la opción Tablas. Podrás ver que el esquema contiene una "tabla" llamada Site_Pages.
2. Podemos utilizar la consulta SELECT UniqueId, ContentType, Created, Modified, ContentVersion FROM Site_Pages LIMIT 10;
   Esto seleccionará las 10 primeras entradas de la lista de páginas web del SharePoint.

Tenga en cuenta que, aunque parezca que estamos utilizando una base de datos directamente, no es así en absoluto. Connect Bridge sólo accede a la API y presenta los datos como si procedieran de una base de datos. Siéntase libre de explorar un poco aquí. También puede explorar los procedimientos almacenados disponibles. Una vez que tengas tu consulta, cópiala, porque la necesitarás en tu código.

También es importante tener en cuenta que, en este momento, sólo está probando cosas. Puede pensar en el Connect Bridge Management Studio como su campo de juego. Una vez que esté satisfecho con la consulta obtenida, sólo tiene que utilizarla en su código, como si estuviera accediendo a una base de datos. Es bastante sencillo.

Para obtener información más detallada, puede consultar la documentación de la pasarela de la API que obtendrá cuando reciba su prueba gratuita. También puede comprobar los registros de la pasarela de la API, que en Connect Bridge se hace fácilmente utilizando Connect Bridge Estudio de gestión utilizando la opción Centro de Administración - Sistema - Registros en la barra de navegación.

El concepto de pasarela API puede sonar demasiado teórico al principio, sin embargo, no es difícil visualizar los beneficios una vez que se centra en una herramienta específica como Connect Bridge.

• El acceso se centraliza en la pasarela de la API, independientemente del número de sistemas de destino
• El hecho de no tener que aprender ninguna API o lenguaje de programación nuevo puede reducir los errores y mejorar la productividad
• El mantenimiento también está centralizado y aislado: todo está en el lado de la pasarela de la API y no en su código, con la compatibilidad hacia adelante garantizada para cada sistema de destino por el propio Connect Bridge (y en realidad también la compatibilidad hacia atrás si alguna vez lo necesita)

Si tiene algún comentario o sugerencia, escríbalo en el siguiente formulario y le responderemos lo antes posible.