ما هو API؟
التعريف
✅التعريف الأساسي
✅أنواع التواصل
مثال المطعم
شبيه بنظام المطعم
✅المكونات
✅كيف يعمل النظام
مثال تطبيقي: تسجيل الدخول
خطوات تسجيل الدخول
✅العملية
✅أنواع الردود المحتملة
API في عالم البيزنس
استخدامات الأعمال
✅الربط بين الأقسام
✅الربط بين الشركات
✅المتطلبات
أمثلة من الواقع
حالات واقعية
✅بوابات الدفع
✅APIs مع البنوك
✅البنوك والجهات التنظيمية
API Documentation
التوثيق
✅الغرض من التوثيق
✅مكونات التوثيق
# API (واجهة برمجة التطبيقات)
ما هو الـ API؟
واجهة برمجة التطبيقات (API) هي وسيلة منظمة لإدارة التواصل بين الأنظمة المختلفة، سواء كان التواصل:
- بين الواجهة الأمامية (Front-end) والخادم (Back-end). - بين خادمين (Back-end ↔ Back-end). - بين أي نظامين تقنيين.
وظيفة الـ API هي تحديد الطلبات المسموح بها وكيفية الرد عليها بطريقة واضحة ومخططة مسبقًا.
---
مثال: تسجيل الدخول
عند إدخال اسم المستخدم وكلمة المرور في صفحة تسجيل الدخول:
1. يرسل الـ Front-end البيانات إلى الـ API. 2. يقوم الـ API بإرسال الطلب إلى الخادم. 3. يتحقق الخادم من صحة البيانات. 4. يعيد الـ API استجابة محددة مسبقًا.
قد تتضمن الاستجابة:
- نجاح أو فشل تسجيل الدخول. - معلومات المستخدم. - آخر وقت لتسجيل الدخول. - أو أي بيانات أخرى تم تصميمها مسبقًا.
> يجب أن تكون جميع الاستجابات معروفة ومحددة مسبقًا ضمن تصميم الـ API.
---
لماذا نستخدم API؟
لا يسمح للواجهة الأمامية بالتواصل مباشرة مع قاعدة البيانات أو الخادم دون API، لأن:
- يحافظ على الأمان. - ينظم طريقة تبادل البيانات. - يمنع الوصول غير المصرح به. - يجعل جميع الطلبات والاستجابات معروفة وواضحة.
---
تشبيه المطعم
يمكن تشبيه الـ API بالمطعم:
- العميل = المستخدم. - النادل = API. - المطبخ = Back-end.
العميل لا يدخل المطبخ مباشرة، وإنما يطلب من خلال النادل.
كما أن الطلبات الموجودة في قائمة الطعام (Menu) تم تحديدها مسبقًا، فإن طلبات الـ API أيضًا تكون مصممة مسبقًا.
---
أمثلة على APIs في البرمجة
قد يطلب مطور الواجهة الأمامية APIs مثل:
- API لتسجيل الدخول. - API لجلب بيانات المستخدم. - API لتحديث البيانات. - API لحذف بيانات المستخدم. - API لرفع الملفات.
كل API له وظيفة واستجابة محددة.
---
استخدام API في عالم الأعمال
لا يقتصر استخدام الـ API على البرمجة، بل يستخدم أيضًا لربط الأنظمة بين:
- أقسام داخل الشركة. - شركتين مختلفتين. - الأنظمة الحكومية. - المؤسسات المالية.
يتم الاتفاق مسبقًا على:
- البيانات المطلوبة. - شكل الطلب (Request). - شكل الاستجابة (Response). - قواعد الأمان.
---
توثيق الـ API (API Documentation)
بعد تصميم الـ APIs يتم إنشاء وثيقة توضح:
- جميع نقاط الاتصال (Endpoints). - طريقة إرسال الطلب. - البيانات المطلوبة. - شكل الاستجابة. - رموز الأخطاء (Error Codes). - أمثلة عملية للاستخدام.
ويستخدم هذا التوثيق من قبل جميع الجهات التي ستتعامل مع النظام.
---
أمثلة عملية
من أشهر استخدامات الـ API:
- بوابات الدفع الإلكتروني. - الربط مع البنوك. - الربط مع الجهات التنظيمية. - أنظمة التحقق من الهوية. - أنظمة الشحن والتوصيل.
وفي هذه الحالات يتم تطبيق أعلى مستويات الأمان والتوثيق لضمان حماية البيانات.
عن هذا الدرس
API (واجهة برمجة التطبيقات) ما هو الـ API؟ واجهة برمجة التطبيقات (API) هي وسيلة منظمة لإدارة التواصل بين الأنظمة المختلفة، سواء كان التواصل: - بين الواجهة… هذا الدرس ضمن مقدمة لمنهج هندسة الكمبيوتر أساسيات الكمبيوتر في أكاديمية موسى.
