ما هو API · البرمجة مع مارتن

اكتشف كيف تتحدث المواقع مع بعضها – وكيف يطلب موقعك الطقس أو الخرائط أو AI.

نادل بين مطبخين

تخيّل مطعماً. أنت (موقعك) تريد طلب طعام، لكن لا يُسمح لك بدخول المطبخ (خدمة أجنبية – طقس، خرائط، AI). لذلك النادل – يأخذ طلبك، يحمله للمطبخ، ويعود بالطبق الجاهز.

ذلك النادل يسمى API (Application Programming Interface). طريقة متفق عليها لبرامج تطلب البيانات من بعضها:

موقعك يرسل طلباً («كيف سيكون الطقس غداً في Brno؟»).
API ينقله للخدمة التي تعرف الجواب.
الخدمة ترجع رداً بصيغة متفق عليها.

شاهد معي: JSON – لغة مشتركة

البرامج ترد على بعضها بصيغة JSON. تبدو تقريباً ككائن JavaScript، الذي تعرفه من الساحر:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

النص بين علامات اقتباس، الأرقام لا.
true/false تعرفها من الشروط.
الأقواس المربعة = قائمة، المعقوفة = كائن.

جرّب الآن – افتح هذا العنوان في متصفحك (API طقس حقيقي، مجاني، بلا تسجيل):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

سترى JSON بالطقس الحالي في Brno. بلا رسوم – بيانات خالصة. أنت تبني الرسوم حولها!

💡

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

دورك الآن 💪

افتح العنوان أعلاه في متصفحك وابحث عن درجة الحرارة الحالية وسرعة الرياح في الرد.
جرّب تغيير latitude وlongitude في العنوان لإحداثيات مدينتك (ابحث عنها في خدمة خرائط – نقرة يمين → «What’s here?»).
اكتب 2–3 أفكار لمشروعك عن بيانات خارجية مفيدة على موقعك:

🏫 موقع المدرسة – أفكار

طقس لرحلة مدرسية، خريطة بموقع المدرسة، قائمة غداء من API المقصف (إن وُجد)، عطل وإجازات.

🙋 موقع شخصي – أفكار

طقس مدينتك، خريطة أماكن زرتها، chatbot AI يجيب عنك للزوار.

🌍 يوميات السفر – أفكار

خريطة بدبابيس لرحلاتك، طقس الوجهة القادمة، تحويل عملة لميزانية السفر.

⚽ موقع النادي – أفكار

طقس لمباراة نهاية الأسبوع، خريطة الملعب للفرق الزائرة، مساعد AI يشرح قواعد كرة القدم.

✅

تحقق: تستطيع شرح ما هو API (نادل بين البرامج) والتعرّف على JSON. رأيت رد API حقيقي في متصفحك.

ما ستخرج به من هذا الدرس

API = طريقة متفق عليها لبرامج تطلب البيانات من بعضها.
الردود بـ JSON – كائنات وقوائم كما في JavaScript.
في الدرس التالي ستسحب بيانات من API مباشرة إلى موقعك بـ fetch.