API gateway là gì và tại sao nó được dùng?

Question

Accepted Answer

Một **API gateway** là điểm vào duy nhất đứng trước các microservice của bạn. Client gọi gateway, gateway định tuyến request đến đúng service và xử lý các mối quan tâm xuyên suốt (cross-cutting concerns).

## Nó làm gì

- **Định tuyến** — chuyển tiếp `/orders/*` đến orders service.
- **Xác thực** — kiểm tra token một lần ở rìa (edge).
- **Giới hạn tốc độ (rate limiting)** — bảo vệ backend khỏi lạm dụng.
- **Gộp (aggregation)** — kết hợp nhiều lời gọi service thành một phản hồi.
- **Kết thúc TLS, logging, caching.**

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

## Ví dụ cấu hình

```yaml
# các route của gateway
routes:
  - path: /orders/**
    service: orders-service   # chuyển tiếp lưu lượng order tới đây
    rateLimit: 100/min        # bóp các client lạm dụng
  - path: /users/**
    service: users-service
    auth: required            # gateway thực thi auth trước khi định tuyến
```

## Cạm bẫy

Gateway có thể trở thành **điểm lỗi đơn (single point of failure)** và là nút thắt cổ chai. Hãy chạy nó ở chế độ sẵn sàng cao và giữ business logic ra ngoài nó.

## Tại sao điều này quan trọng

Một gateway giải phóng mỗi service khỏi việc cài lại auth, rate limiting, và TLS, và mang lại cho client một URL ổn định duy nhất thay vì hàng chục địa chỉ.

Không có nó, client phải biết địa chỉ của từng service và lặp lại logic xuyên suốt, điều này nhanh chóng trở nên khó quản lý.