📂TI·datos·DX⏱Lectura de 2 min📊Práctica🔗Relacionados 3

¿Qué es API Gateway?

Definición en una línea
La «puerta principal» por la que pasan todas las solicitudes dirigidas a varios servicios de backend. Gestiona la autenticación, el enrutamiento y los límites en un solo punto.
⚡ Resumen en 3 líneas
  • 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.

Capacitaciones en las que aparece este término · IA·DX
Cursos recomendados · Instructores recomendados · Mini cotización
🧮 Mini cotización · Criterio de honorarios
Aprox. KRW 1,200,000 (≈ US$900)Charla especial de 2 horas · hasta 20 personas · en coreano
Solicitar cotización formal con estas condiciones →
💡 Dicho de forma sencilla
Como el mostrador de informes en la entrada de un edificio: recibe cada visita (solicitud), verifica la identidad y la dirige al lugar correcto.
Por qué es importante en la práctica
A medida que aumentan los servicios, es más seguro y ordenado concentrar en un solo punto el procesamiento común, como la autenticación y los límites de uso.
Origen y fuentes

Con 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.

Entender con un caso

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.

  1. 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».
  2. 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 %.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
Términos relacionados
Capacitaciones relacionadas con este término
📚Transformación digitalCapacitación corporativa de Nanum Consultoría · presencial/en líneaVer curso →
¿Necesita capacitación interna sobre este tema?
Reciba de inmediato un currículo y una cotización personalizados para su equipo.
Consultar sobre capacitación
Última modificación 2026-09-13 · Revisado por John Kim

Preguntas frecuentes

Las funciones comunes, como la autenticación y los límites, se gestionan en un solo lugar sin tener que desarrollarlas en cada servicio, lo que aumenta la coherencia y la seguridad.
El balanceador de carga se centra en la «distribución de carga», mientras que el API Gateway cumple funciones de gestión de API más amplias, como la autenticación y el enrutamiento.
Las funciones comunes, como la autenticación y los límites, se gestionan en un solo lugar sin tener que desarrollarlas en cada servicio, lo que aumenta la coherencia y la seguridad.
El balanceador de carga se centra en la «distribución de carga», mientras que el API Gateway cumple funciones de gestión más amplias, como la autenticación y el enrutamiento.