O que é um gateway de API e por que é usado?

Question

Accepted Answer

Um **gateway de API** é um único ponto de entrada que fica na frente de seus microsserviços. Os clientes chamam o gateway, que roteia as solicitações para o serviço correto e trata das responsabilidades transversais.

## O que faz

- **Routing** — encaminhe `/orders/*` para o serviço de pedidos.
- **Authentication** — verifique tokens uma vez na borda.
- **Rate limiting** — proteja os backends do abuso.
- **Aggregation** — combine várias chamadas de serviço em uma resposta.
- **TLS termination, logging, caching.**

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

## Configuração de exemplo

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

## Armadilha

O gateway pode se tornar um **único ponto de falha** e um gargalo. Execute-o com alta disponibilidade e mantenha a lógica de negócios fora dele.

## Por que isso importa

Um gateway liberta cada serviço de reimplementar autenticação, limitação de taxa e TLS, e oferece aos clientes uma URL estável em vez de dezenas.

Sem ele, os clientes devem conhecer o endereço de cada serviço e duplicar a lógica transversal, o que rapidamente se torna incontrolável.