API Gateway
API Gateway
¿Qué es API Gateway?
- La «puerta principal» por la que pasan todas las solicitudes
- Autenticación, enrutamiento y límites en un solo lugar
- Frente a los microservicios
Al poner un API Gateway al frente, la cantidad de direcciones que el cliente debe recordar se reduce a una sola. La app móvil ya no necesita guardar por separado los dominios de los servicios de pedidos, inventario y liquidación, y aunque internamente se dividan servicios o se cambie de servidor, desaparece la necesidad de volver a publicar la app y esperar la aprobación. Lo que cambia no es el número de llamadas, sino el alcance hacia el que se filtran los cambios. Es más preciso entenderlo como un mecanismo que separa la estructura interna de las interfaces que se han prometido hacia afuera.
Si trazas límites entre cosas que se parecen, el diseño resulta más sencillo. El balanceador de carga se concentra en repartir el tráfico de manera uniforme entre varias instancias del mismo servicio. La malla de servicios (service mesh) gestiona la comunicación interna que los servicios intercambian entre sí. El API gateway se encarga del tráfico norte-sur (north-south) que entra desde fuera. Los valores de configuración también son bastante concretos. Se fijan límites por clave emitida, por ejemplo 60 solicitudes por minuto para las claves de socios y 600 por minuto para las herramientas internas de administración. El tiempo de espera de respuesta suele fijarse entre 3 y 10 segundos. La demora que agrega cada capa adicional está en el orden de unos pocos milisegundos a decenas de milisegundos. Si hay que armar la forma de la respuesta de manera distinta según el tipo de cliente, esa tarea corresponde al BFF (Backend For Frontend), no al gateway.
En la práctica, el error más frecuente es que la lógica de negocio se acumule en el Gateway. Cuando empiezan a meter cosas como el cálculo de descuentos o la clasificación por nivel de membresía con la idea de que «así se resuelve todo en un solo lugar», el Gateway se convierte en un nuevo punto único de falla: si cualquier equipo despliega algo, todos los servicios se detienen juntos. También es común que, por haber postergado la redundancia, la caída de un solo Gateway deje fuera de servicio a diez servicios que estaban sanos. Tampoco es seguro pensar que, como la autenticación se hizo en la puerta principal, el interior puede quedar sin protección. Si la red interna se vulnera, quedan expuestos todos los servicios, así que en los servicios internos debe mantenerse una validación mínima de tokens.
Seungtae ParkInstructor de AX práctico que enseña construyendo en vivo proyectos de desarrollo de negocio con IA y automatización de marketing
Ilyoung JungEspecialista en fábricas inteligentes, gestión de equipos y la Cuarta Revolución IndustrialCon la expansión de la arquitectura de microservicios, este patrón de punto de entrada único frente a varios servicios se consolidó como práctica habitual.
Veamos un caso hipotético. La empresa A, distribuidora de alimentos en línea con unos 320 colaboradores, tenía una estructura en la que su propia app, su web y seis marketplaces asociados llamaban directamente, cada uno por su cuenta, a once servicios internos. Como el código de autenticación variaba un poco de un cliente a otro, cambiar una sola línea de la política de vencimiento de tokens tomaba dos semanas; además, en una ocasión, una avalancha de consultas de inventario de uno de los marketplaces paralizó durante 12 minutos hasta el servicio de pedidos.
- Al extraer tres semanas de registros de llamadas, el líder del equipo de plataforma vio que el 41 % de todas las solicitudes eran consultas de inventario, y que la mitad de ellas provenían de un solo marketplace asociado. En la reunión se dijo: «El problema es que no existe ningún punto donde poder frenarlo».
- Se instaló un API Gateway administrado como puerta principal y se empezó migrando primero las API de los marketplaces asociados. El gerente de backend optó por un traslado gradual: mantuvo abiertos los dominios anteriores durante tres meses y fue pasando el tráfico del 10 % al 50 % y luego al 100 %.
- Se concentró la validación de tokens en un único punto, el Gateway, y se fijó un límite de 60 solicitudes por minuto para cada clave de socio. Lo que excediera ese límite se devolvía con el código 429, y el intervalo de reintento se incluía en el encabezado de respuesta para orientar a los desarrolladores de los socios.
- Surgió la propuesta de «calcular también los descuentos por nivel en el Gateway», pero el CTO la rechazó con el principio de que la lógica de negocio debe quedar en cada servicio. Se fijó de forma explícita que el Gateway se encargue solo de cuatro funciones: autenticación, enrutamiento, límites y registro de logs.
- El API Gateway se duplicó en dos zonas de disponibilidad, con verificación de estado cada 5 segundos y conmutación automática ante fallas. El responsable de infraestructura decidió hacer cada trimestre un ejercicio en el que apaga a la fuerza una de las instancias.
- Seis meses después, el trabajo de cambio de la política de tokens pasó de dos semanas a medio día, y las fallas originadas en los marketplaces asociados bajaron de 4 a 0 en el mismo periodo. La latencia promedio de respuesta aumentó 9 ms, pero como desaparecieron las pérdidas de pedidos por fallas, las áreas de negocio también lo aceptaron.