ما هي بوابة API وماذا تفعل؟

Question

Accepted Answer

**بوابة API** هي نقطة دخول واحدة توجد أمام الخدمات الخلفية — وتتعامل مع الاهتمامات المتقاطعة مثل التوجيه والمصادقة وتحديد معدل الطلبات والمزيد. وهي مفيدة بشكل خاص في بنى الخدمات الدقيقة (microservices) لتركيز الوظائف المشتركة.

## ما تفعله بوابة API

```text
The API GATEWAY is a single entry point in front of backend services:
  Client → API GATEWAY → ┬→ Service A
                         ├→ Service B
                         └→ Service C
  → handles cross-cutting concerns in ONE place (so services don't each implement them)
  → routes requests to the right service; abstracts the backend from clients
```

## مسؤوليات البوابة الشائعة

```text
✓ ROUTING → direct requests to the appropriate backend service
✓ AUTHENTICATION/authorization → verify identity/permissions centrally
✓ RATE LIMITING / throttling → protect backends from abuse/overload
✓ Request/response TRANSFORMATION; protocol translation; aggregation (combine service calls)
✓ CACHING; load balancing; SSL termination
✓ LOGGING, monitoring, analytics; error handling
```

## لماذا نستخدم بوابة API

```text
✓ CENTRALIZE cross-cutting concerns → services don't each reimplement auth, rate limiting,
  etc. (DRY, consistent) — especially valuable with many microservices
✓ SINGLE entry point → simpler for clients; hides internal service structure
✓ Consistent security, monitoring, and policies across services
⚠️ but → can become a bottleneck or single point of failure (scale/HA it); adds a layer
→ very common in MICROSERVICES architectures.
```

## لماذا هذا مهم

فهم بوابة API له قيمة لأنها **مكون شائع ومهم** خاصة في بنى الخدمات الدقيقة، وتركز الاهتمامات المتقاطعة، لذلك فهي معرفة مفيدة في تصميم الأنظمة.

بوابة API — نقطة دخول واحدة أمام الخدمات الخلفية — تعالج حاجة مهمة في الأنظمة التي تحتوي على خدمات متعددة: التعامل مع **الاهتمامات المتقاطعة في مكان واحد** بدلاً من أن تعيد كل خدمة تطبيقها.

فهم **المسؤوليات الشائعة** — التوجيه (توجيه الطلبات إلى الخدمة الصحيحة)، **المصادقة والتفويض** المركزية، **تحديد معدل الطلبات**، تحويل واجتماع الطلبات والاستجابات، التخزين المؤقت، موازنة الحمل، إنهاء SSL، والتسجيل والمراقبة — يوضح نطاق الوظائف التي تركزها البوابة.

فهم **لماذا نستخدم واحدة** هو القيمة الأساسية: فهي **تركز الاهتمامات المتقاطعة** (بحيث لا تعيد كل خدمة تطبيق المصادقة وتحديد معدل الطلبات وغيرها — مما يحافظ عليها جافة ومتسقة، خاصة مع خدمات دقيقة كثيرة)، وتوفر **نقطة دخول واحدة** (أبسط للعملاء، وتخفي البنية الداخلية)، وتضمن الأمان والمراقبة والسياسات المتسقة.

فهم التحذير من أن البوابة يمكن أن تصبح **اختناقاً أو نقطة فشل واحدة** (تتطلب التوسع والتوفر العالي) وتضيف طبقة يعكس فهماً متوازناً.

بوابة API هي مكون قياسي في بنى الخدمات الدقيقة (والتي بخلاف ذلك ستنثر الاهتمامات المتقاطعة عبر خدمات عديدة)، مما يجعل من المهم فهمها لتصميم الأنظمة الحديثة.

نظراً لأن بوابة API مكون شائع ومهم (خاصة في الخدمات الدقيقة) يركز الاهتمامات المتقاطعة (التوجيه والمصادقة وتحديد معدل الطلبات) في نقطة دخول واحدة، ولأن فهم ما تفعله ولماذا يتم استخدامها له قيمة في تصميم الأنظمة القائمة على الخدمات، فإن فهم بوابة API له قيمة وذو صلة عملية — معرفة تصميم أنظمة مهمة — مكون قياسي في بنى الخدمات الدقيقة لتركيز الاهتمامات المتقاطعة، وتوفير نقطة دخول واحدة وسياسات متسقة، ومكون بناء مهم لتصميم الأنظمة المكونة من خدمات متعددة.