Ir al contenido
dc.
Volver al trabajo destacado

Proyecto de código abierto

API Gateway en TypeScript: enrutamiento y resiliencia

Un gateway de API configurable que reúne enrutamiento, resiliencia y observabilidad.

TypeScriptNode.jsNext.js

2 min de lectura

Explora el sistema

De un vistazo

Organización
Proyecto independiente de código abierto
Mi función
Autor del proyecto
Período
Desarrollo de código abierto
gestión del tráfico mediante configuración
Enrutar. Proteger. Observar.

Las capacidades del proyecto están documentadas en los repositorios públicos enlazados. No se afirma su adopción en producción.

Gateway / flujo de solicitudes
GET /api/orders 200
ClienteGatewayServicio
autenticaciónlímite de solicitudescortacircuitos

El problema

Las aplicaciones que se comunican con varios servicios necesitan repetidamente enrutamiento, autenticación, límites de tráfico y gestión de fallos. Implementar estas políticas por separado puede generar comportamientos inconsistentes y trabajo duplicado.

Este proyecto explora un punto de entrada compartido con configuración tipada y validada, además de herramientas operativas.

El sistema

El gateway dirige solicitudes HTTP a los servicios de destino. Sus funciones documentadas incluyen autenticación y límites de solicitudes por ruta, cortacircuitos, balanceo de carga, tiempos de espera, políticas de reintentos, caché, proxy de WebSocket y métricas de Prometheus.

Un panel de Next.js permite configurar el sistema visualmente, mientras que una herramienta de línea de comandos permite gestionar la configuración e importar y exportar OpenAPI.

Decisiones y compromisos

La configuración como contrato. Las rutas se validan antes de registrarse, de modo que una configuración incorrecta se detecta explícitamente durante el arranque.

Políticas en un límite compartido. La autenticación, el control de tráfico y el seguimiento de solicitudes pueden aplicarse de forma consistente antes de llegar a los servicios de la aplicación.

El comportamiento operativo forma parte de la API. Un tiempo de espera agotado, un circuito abierto y un fallo de autenticación tienen significados distintos. Necesitan respuestas predecibles y registros útiles.

El estado distribuido necesita límites explícitos. El repositorio documenta tanto el estado local como los almacenes compartidos inyectables, incluidas las limitaciones de las instantáneas del cortacircuitos cuya última escritura prevalece. Compartir visibilidad no implica actualizaciones atómicas entre procesos.

Explorar la ruta de fallo

El ejemplo interactivo de esta página ilustra un circuito disponible y uno abierto. Es una simulación simplificada: no ejecuta el gateway ni modela sus umbrales de fallo o temporizadores de recuperación.

Evidencia y siguientes pasos

El repositorio público incluye documentación de arquitectura, ejemplos ejecutables y comandos de pruebas. Son el punto de partida para inspeccionar la implementación. Este portafolio no afirma cifras verificadas de forma independiente sobre capacidad de procesamiento, disponibilidad o adopción en producción.

API Gateway

Explora el sistema

Sigue tres rutas de fallo documentadas. Son trazas ilustrativas basadas en ejemplos del repositorio; no son solicitudes a un gateway en ejecución.

Recorrido de la solicitud

  1. 01Cliente
  2. 02Políticas de la ruta
  3. 03Servicio de destino
  4. 04Respuesta al cliente

La ruta seleccionada aplica sus políticas antes de reenviar. La autenticación puede detener la solicitud en el límite; un tiempo de espera puede cancelar una solicitud al servicio; un circuito abierto evita llamar al servicio que falla.

Fallo de autenticación401

Traza ilustrativa

  1. GET /reports sin el encabezado x-api-key.
  2. La ruta exige una clave de API; se rechaza la solicitud.
  3. No se llama al servicio de destino. El cliente recibe 401.

Configuración publicada de la ruta

[
  {
    "baseURL": "/reports",
    "proxy": {
      "target": "http://localhost:4005",
      "changeOrigin": true,
      "pathRewrite": {
        "^/reports": ""
      }
    },
    "auth": {
      "enabled": true,
      "strategy": "apiKey",
      "header": "x-api-key",
      "keys": [
        "key-service-alpha-123",
        "key-service-beta-456"
      ]
    }
  }
]
Tiempo de espera agotado504

Traza ilustrativa

  1. GET /slow se reenvía al servicio de destino configurado.
  2. La respuesta no comienza dentro de los 100 ms configurados.
  3. Se cancela la conexión al servicio. El cliente recibe 504.

Configuración publicada de la ruta

[
  {
    "baseURL": "/slow",
    "proxy": {
      "target": "http://localhost:4073",
      "pathRewrite": {
        "^/slow": ""
      },
      "timeout": 100
    }
  }
]
Circuito abierto503

Traza ilustrativa

  1. Se supone que el circuito de /payments ya está abierto tras alcanzar su umbral de fallos.
  2. Llega otra solicitud antes de terminar la ventana de recuperación de 10,000 ms.
  3. El gateway omite la llamada al servicio. El cliente recibe 503.

Configuración publicada de la ruta

[
  {
    "baseURL": "/payments",
    "proxy": {
      "target": "http://localhost:4006",
      "changeOrigin": true,
      "pathRewrite": {
        "^/payments": ""
      }
    },
    "circuitBreaker": {
      "threshold": 3,
      "timeout": 10000,
      "successThreshold": 1
    }
  }
]

Decisiones de arquitectura

Configuración validada
Un contrato de rutas tipado centraliza las políticas. La alternativa es escribir middleware en cada servicio, lo que ofrece flexibilidad pero duplica validaciones y conexiones entre políticas. La configuración también requiere revisión y pruebas.
Controles de fallo separados
Los tiempos de espera limitan la espera; los cortacircuitos detienen llamadas repetidas a una dependencia con fallos. Los reintentos son otra decisión: habilitarlos indiscriminadamente puede amplificar la carga o duplicar escrituras.

Ejecución local registrada

Del fallo a la recuperación

Respuestas HTTP capturadas ejecutando el gateway con un servicio de prueba local. El umbral es de tres fallos y la espera de recuperación es de un segundo. La reproducción resume los pasos; no representa su duración real.

Sin audio. Grabado el. Código de esta ejecución.

Respuestas capturadas y llamadas al servicio
  1. Servicio disponible · HTTP 200

    Solicitudes al servicio: 1

                  {
      "service": "payments",
      "healthy": true
    }
                
  2. Primer fallo · HTTP 500

    Solicitudes al servicio: 1

                  {
      "error": "Local demonstration failure"
    }
                
  3. Segundo fallo · HTTP 500

    Solicitudes al servicio: 1

                  {
      "error": "Local demonstration failure"
    }
                
  4. Tercer fallo · HTTP 500

    Solicitudes al servicio: 1

                  {
      "error": "Local demonstration failure"
    }
                
  5. Circuito abierto · HTTP 503

    Solicitudes al servicio: 0

                  {
      "error": "Service Unavailable",
      "message": "Circuit breaker open — upstream is not responding",
      "code": "CIRCUIT_OPEN"
    }
                
  6. Sondeo de recuperación · HTTP 200

    Solicitudes al servicio: 1

                  {
      "service": "payments",
      "healthy": true
    }
                

Cuando falla una dependencia

Simulación ilustrativa

Explora dos estados del circuito. Los umbrales, temporizadores y sondeos de recuperación se simplifican en este ejemplo.

Respuesta

200 Correcto

Circuito

Cerrado

El circuito cerrado reenvía solicitudes al servicio de destino disponible.

05 Conversemos

Un buen trabajo empieza
con una conversación.

¿Tienes un reto de ingeniería, una oportunidad profesional o una idea que vale la pena explorar? Me gustaría conocerla.

derian.cordoba@icloud.com

Desde Nicaragua · Colaborando con equipos internacionales

Conversemos

Envíame una breve presentación

¿Tienes una oportunidad, una colaboración o un reto técnico en mente? Comparte un poco de contexto para comenzar la conversación.

Oportunidades · Colaboración · Ingeniería

¿Prefieres escribirme directamente?

derian.cordoba@icloud.com

Todos los campos son obligatorios.

Netlify Forms procesa tu nombre, correo y mensaje para entregar tu consulta. Evita incluir información confidencial.