ما هو الـ API؟ وكيف يعمل؟

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

في هذه المقالة سنشرح:

• ما هو الـ API؟
• كيف يعمل؟
• لماذا هو ضروري في البرمجة وتطبيقات الويب؟
• ما أشهر أنواعه واستخداماته؟
• وهل من السهل تعلمه واستخدامه؟

ما هو الـ API؟

التعريف:

API هي اختصار لـ:
Application Programming Interface
وتُترجم إلى: واجهة برمجة التطبيقات.

تعريف مبسّط:

الـ API هو “جسر” يسمح لتطبيقين مختلفين بالتواصل مع بعضهما البعض، وتبادل المعلومات أو تنفيذ أوامر، دون أن يحتاج أحد الطرفين لمعرفة كيف يعمل الآخر داخليًا.

تشبيه بسيط لفهم API

تخيل أنك في مطعم، وتطلب وجبتك من خلال النادل.

• أنت: تمثل المستخدم أو التطبيق.
• النادل: هو الـ API.
• المطبخ: هو الخادم (Server) الذي يحضّر الطعام (البيانات أو العمليات).

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

لماذا نستخدم API؟

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

كيف يعمل API؟

الخطوات الأساسية:

1. العميل (Client) يرسل طلب (Request) إلى API.
2. API يستقبل الطلب، ويتحقق منه.
3. API يُرسل الطلب إلى الخادم أو قاعدة البيانات.
4. الخادم يُعالج الطلب ويرجع بالنتيجة.
5. API يُعيد النتيجة إلى العميل بصيغة مفهومة (غالبًا JSON أو XML).

مثال عملي:

تخيل تطبيق طقس يُظهر لك درجة الحرارة.
التطبيق يرسل طلبًا إلى API الطقس:

https://api.weatherapi.com/v1/current.json?key=12345&q=Cairo

الـ API يُعيد نتيجة:

{
  "location": {
    "name": "Cairo"
  },
  "current": {
    "temp_c": 33.0
  }
}

التطبيق يأخذ هذه البيانات ويعرضها للمستخدم.

أنواع API

1. APIs مفتوحة (Public APIs)

• متاحة لأي مطور.
• أمثلة: واجهة خرائط جوجل، OpenWeather.

2. APIs خاصة (Private APIs)

• تُستخدم داخل شركة أو مشروع فقط.
• مثل: API داخلي لإدارة الموظفين أو الطلبات.

3. APIs شريكة (Partner APIs)

• متاحة لأطراف معينة بشروط.
• مثل: بوابة دفع تسمح فقط لتجار معينين بالوصول إلى بيانات المعاملات.

أشهر تنسيقات API

• JSON (JavaScript Object Notation): الأكثر استخدامًا – خفيف وسهل القراءة.
• XML: قديم قليلًا لكن لا يزال مستخدمًا في بعض الأنظمة.

بروتوكولات API

1. REST API

• الأكثر استخدامًا حاليًا.
• يعتمد على بروتوكول HTTP.
• يستخدم طرق مثل:
  • GET (لجلب البيانات)
  • POST (لإرسال بيانات)
  • PUT (لتعديل بيانات)
  • DELETE (لحذف بيانات)

2. SOAP API

• أقدم وأثقل – يستخدم XML فقط.
• أكثر أمانًا لكن أقل مرونة. يُستخدم في الأنظمة البنكية أو الحكومية.

3. GraphQL

• نظام حديث نسبيًا من فيسبوك.
• يسمح بجلب بيانات محددة بدقة عالية.

استخدامات شائعة للـ API

المجال	أمثلة على استخدام API
الطقس	جلب بيانات الطقس من مواقع مثل OpenWeather
الدفع الإلكتروني	ربط الموقع بخدمة مثل PayPal أو Stripe
الخرائط	استخدام Google Maps في مواقع الحجوزات
تسجيل الدخول	الدخول باستخدام حساب Google أو Facebook
التجارة الإلكترونية	جلب المنتجات من نظام خارجي وإظهارها على الموقع

كيف أتعامل مع API في البرمجة؟

ببساطة، عبر كتابة طلب (Request)، وانتظار الرد (Response).
أغلب لغات البرمجة مثل JavaScript، Python، PHP، تُتيح أدوات جاهزة للتعامل مع API.

مثال بلغة JavaScript:

fetch("https://api.weatherapi.com/v1/current.json?key=12345&q=Cairo")
  .then(response => response.json())
  .then(data => console.log(data));

أهمية API في تطوير الويب والتطبيقات

✅ تسريع عملية التطوير
✅ تكامل قوي مع خدمات الطرف الثالث
✅ إعادة استخدام نفس الكود في تطبيقات متعددة (موقع – تطبيق موبايل)
✅ فصل منطق الواجهة عن الخادم (Front-end عن Back-end)
✅ أمان وتحكم في الوصول إلى البيانات عبر رموز المصادقة مثل JWT أو OAuth

---

هل من السهل تعلم استخدام API؟

نعم، خاصة إن كنت تعرف:

• أساسيات HTTP (GET / POST)
• كيفية التعامل مع JSON
• لغة برمجة مثل JavaScript أو Python

المصادر والدروس كثيرة، ويمكنك البدء بتجربة APIs مفتوحة مثل:

• https://jsonplaceholder.typicode.com
• https://api.openweathermap.org

أهم المصطلحات المرتبطة بـ API

المصطلح	الشرح
Endpoint	عنوان URL يُستخدم للوصول لوظيفة محددة في الـ API
Request	الطلب الذي ترسله للـ API
Response	الرد الذي يرجع من الـ API
Authentication	عملية التحقق من هوية المستخدم
Rate Limit	عدد المرات التي يمكنك فيها استخدام الـ API خلال وقت معين

الأسئلة الشائعة (FAQ)

ما الفرق بين API وWeb Service؟

كل Web Service هو API، لكن ليس كل API هو Web Service.
Web Service تعمل عبر الإنترنت باستخدام بروتوكول معين مثل SOAP، بينما API أوسع.

هل API تعمل بدون إنترنت؟

غالبًا لا، لأن معظم APIs تعتمد على إرسال الطلب إلى خادم عبر الإنترنت.

هل يمكن بناء API خاص بي؟

نعم، يمكنك برمجة API خاص باستخدام لغات مثل:

• Node.js
• PHP
• Python (Django REST)
• Java

هل أحتاج API لبناء موقع؟

ليس دائمًا، ولكن عند بناء تطبيق ديناميكي أو التعامل مع بيانات من طرف ثالث، تُعتبر API ضرورية جدًا.

الـ API هو البوابة التي تربط بين التطبيقات والأنظمة المختلفة.
من خلاله يمكن لتطبيقاتك:

• التواصل مع قواعد البيانات
• استخدام خدمات جاهزة
• تبادل البيانات مع أطراف ثالثة

سواء كنت مطور مواقع، تطبيقات موبايل، أو مهتم بتقنيات الويب، فـ فهم الـ API هو مهارة أساسية يجب تعلمها.
ابدأ اليوم بتجربة بعض APIs المجانية، وستكتشف كيف يمكنك بناء تطبيقات أكثر قوة واحترافية.