ما هو بوابة API ولماذا يتم استخدامه؟

Question

Accepted Answer

**بوابة API** هي نقطة دخول موحدة توجد أمام خدماتك الدقيقة (microservices). يتصل العملاء بالبوابة، والتي توجه الطلبات إلى الخدمة الصحيحة وتتعامل مع الاهتمامات المشتركة.

## ما تفعله

- **التوجيه (Routing)** — إعادة توجيه `/orders/*` إلى خدمة الطلبات.
- **المصادقة (Authentication)** — التحقق من الرموز مرة واحدة على الحافة.
- **تحديد معدل (Rate limiting)** — حماية الخوادم الخلفية من الإساءة.
- **التجميع (Aggregation)** — دمج عدة استدعاءات خدمة في رد واحد.
- **إنهاء TLS والتسجيل والتخزين المؤقت.**

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

## مثال على التكوين

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

## الفخ

قد تصبح البوابة **نقطة فشل واحدة** واختناق. قم بتشغيلها بتوفر عالي واحفظ المنطق التجاري بعيداً عنها.

## لماذا الأمر مهم

تحرر البوابة كل خدمة من إعادة تنفيذ المصادقة وتحديد المعدل و TLS، وتعطي العملاء عنوان URL واحد مستقر بدلاً من العشرات.

بدونها، يجب على العملاء معرفة عنوان كل خدمة وتكرار المنطق المشترك، الأمر الذي يصبح غير قابل للإدارة بسرعة.