Cos'è un API gateway e perché viene utilizzato?

Question

Accepted Answer

Un **API gateway** è un unico punto di ingresso che si trova di fronte ai tuoi microservizi. I client chiamano il gateway, che instrada le richieste al servizio corretto e gestisce i cross-cutting concerns.

## Perché è importante

- **Routing** — inoltra `/orders/*` al servizio orders.
- **Authentication** — verifica i token una volta al margine.
- **Rate limiting** — protegge i backend dagli abusi.
- **Aggregation** — combina più chiamate di servizio in una sola risposta.
- **TLS termination, logging, caching.**

```text
            ┌─────────────────────────────┐
  Clients ─▶│        API Gateway          │
            │  auth · rate-limit · route  │
            └──┬──────────┬──────────┬────┘
               ▼          ▼          ▼
           Orders     Payments    Users
```

## Esempio di configurazione

```yaml
# gateway routes
routes:
  - path: /orders/**
    service: orders-service   # forward order traffic here
    rateLimit: 100/min        # throttle abusive clients
  - path: /users/**
    service: users-service
    auth: required            # gateway enforces auth before routing
```

## Insidia

Il gateway può diventare un **singolo punto di guasto** e un collo di bottiglia. Eseguilo con alta disponibilità e mantieni la logica di business fuori da esso.

## Perché è importante

Un gateway libera ogni servizio dall'implementare nuovamente l'autenticazione, il rate limiting e TLS, e fornisce ai client un unico URL stabile invece di decine.

Senza di esso, i client devono conoscere l'indirizzo di ogni servizio e duplicare la logica cross-cutting, il che diventa rapidamente ingestibile.