Ce este o poartă API și de ce este utilizată?

Question

Accepted Answer

O **poartă API** este un singur punct de intrare care se află în fața microserviciilor tale. Clienții apelează poarta, care direcționează cererile către serviciul corect și gestionează preocupările transversale.

## Ce face

- **Routing** — redirecționează `/orders/*` către serviciul de comenzi.
- **Authentication** — verifică tokenurile o dată la margine.
- **Rate limiting** — protejează backend-urile de abuz.
- **Aggregation** — combină mai multe apeluri de serviciu într-un răspuns.
- **TLS termination, logging, caching.**

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

## Exemplu de configurație

```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
```

## Capcană

Poarta poate deveni un **singur punct de eșec** și o îngustare. Rulează-o cu disponibilitate ridicată și ține logica de business departe de ea.

## De ce este important

O poartă eliberează fiecare serviciu de la re-implementarea autentificării, limitării ratei și TLS, și oferă clienților un singur URL stabil în loc de zeci.

Fără ea, clienții trebuie să cunoască adresa fiecărui serviciu și să duplice logica transversală, ceea ce rapid devine imposibil de gestionat.