Puertas de enlace de API: qué resuelven y qué complican
Una puerta de enlace resuelve problemas reales y crea uno nuevo: se convierte en el sitio donde todo el mundo pone lo que no sabe dónde poner.
Qué concentra una puerta de enlace
Es un punto único por el que pasan las llamadas antes de llegar a los servicios que las atienden. Ahí se resuelven cosas que, de otro modo, cada servicio tendría que resolver por su cuenta: autenticación, límites de uso, registro, versiones.
El argumento a favor es sólido: evita repetir la misma lógica en veinte sitios y da un lugar donde mirar cuando algo falla.
Lo que corresponde y lo que no
| Función | ¿En la puerta de enlace? |
|---|---|
| Autenticación y autorización básica | Sí |
| Límite de peticiones | Sí |
| Registro y trazabilidad | Sí |
| Enrutado y versiones | Sí |
| Transformación ligera de formato | Con cuidado |
| Reglas de negocio | No |
| Orquestación de varios servicios | Casi nunca |
| Validación específica de un dominio | No |
La deriva característica
Empieza con una transformación pequeña porque un cliente antiguo espera otro formato. Sigue con una condición porque un caso es especial. Dos años después la puerta de enlace contiene lógica de negocio que nadie sabe explicar, no está en ningún repositorio con revisión y no se puede probar.
Es la forma en que un componente pensado para simplificar se convierte en el sistema heredado del que hablaba el texto anterior.
Preguntas antes de introducir una
- ¿Qué problema concreto resuelve hoy? Si la respuesta es «ordenar», conviene concretar más.
- ¿Quién la mantiene? Un componente central sin responsable claro se degrada deprisa.
- ¿Cómo se prueba un cambio antes de que afecte a todo el tráfico?
- ¿Cómo se revierte, y en cuánto tiempo?
- ¿Qué se registra y durante cuánto tiempo? Si pasan datos personales, esa decisión tiene consecuencias legales.
- ¿Qué ocurre si se cae? ¿Hay degradación parcial o parada total?
Datos personales de paso
Una puerta de enlace ve el contenido de las peticiones, que con frecuencia incluye datos personales. Registrar cuerpos completos «por si acaso» crea un almacén de datos sensibles que nadie planificó, con obligaciones de conservación y acceso que nadie definió. Es una decisión de arquitectura y también de cumplimiento.
