Co to jest brama API i dlaczego jest używana?

Question

Accepted Answer

**Brama API** to pojedynczy punkt wejścia, który znajduje się przed twoimi mikrousługami. Klienci wywołują bramę, która kieruje żądania do odpowiedniej usługi i obsługuje zagadnienia przekrojowe.

## Co robi

- **Routing** — przekieruj `/orders/*` do usługi zamówień.
- **Authentication** — zweryfikuj tokeny raz na krawędzi.
- **Rate limiting** — chroń backendy przed nadużyciami.
- **Aggregation** — połącz kilka wywołań usługi w jedną odpowiedź.
- **TLS termination, logging, caching.**

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

## Przykładowa konfiguracja

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

## Pułapka

Brama może stać się **pojedynczym punktem awarii** i wąskim gardłem. Uruchamiaj ją z wysoką dostępnością i trzymaj logikę biznesową z dala od niej.

## Dlaczego to ważne

Brama zwalnia każdą usługę z ponownego wdrażania autentykacji, ograniczania szybkości i TLS, a klienci otrzymują jeden stabilny adres URL zamiast dziesiątek.

Bez niej klienci muszą znać adresy każdej usługi i duplikować logikę przekrojową, co szybko staje się nie do opanowania.