Mikä on API-yhdyskäytävä ja miksi sitä käytetään?

Question

Accepted Answer

**API-yhdyskäytävä** on yksittäinen sisääntulopiste, joka sijaitsee microservices-palveluiden edessä. Asiakkaat kutsuvat yhdyskäytävää, joka ohjaa pyynnöt oikeaan palveluun ja käsittelee poikittaisia huolenaiheita.

## Mitä se tekee

- **Reitittäminen** — ohjaa `/orders/*` tilaus-palveluun.
- **Todennus** — tarkista tunnukset kerran reunalla.
- **Nopeuden rajoittaminen** — suojaa backend-palveluita väärinkäytöltä.
- **Yhdistäminen** — yhdistä useat palvelukutsut yhdeksi vastaukseksi.
- **TLS-päättäminen, lokitiedot, välimuistintaminen.**

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

## Esimerkkikonfiguraatio

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

## Sudenkuoppa

Yhdyskäytävä voi muuttua **ainoaksi vikapisteeksi** ja pullonkaulaksi. Käytä sitä korkean saatavuuden kanssa ja pidä liiketoimintalogiikka poissa siitä.

## Miksi sillä on merkitystä

Yhdyskäytävä vapauttaa jokaisen palvelun todennuksen, nopeuden rajoittamisen ja TLS:n uudelleentoteutuksesta, ja antaa asiakkaille yhden vakaan URL-osoitteen kymmenien sijasta.

Ilman sitä asiakkaiden on tiedettävä jokaisen palvelun osoite ja kopioitava poikittainen logiikka, mikä nopeasti muuttuu hallitsemattomaksi.