ما هو API؟ الشرح المبسط الوحيد الذي ستحتاجه (مع 6 أمثلة حقيقية ورسوم توضيحية)
كل مرة تفتح فيها تطبيق الطقس وترى درجة الحرارة — هذا الطلب يمر عبر شيء يُسمى API. كل مرة تدفع فيها أونلاين وتظهر لك رسالة "تمت العملية بنجاح" — هذا أيضاً API. كل مرة تبحث في يوتيوب عن فيديو — API مرة أخرى. API اختصار لـ Application Programming Interface — وببساطة شديدة: هو "النادل" الذي ينقل طلبك من تطبيقك إلى الخادم ويعيد لك النتيجة. هذا المقال سيشرح لك المفهوم بالكامل بلا مصطلحات معقدة — مع 6 أمثلة حقيقية من تطبيقات تستخدمها يومياً.
تشبيهات واقعية: افهم API في دقيقة
تشبيه المطعم — الأقوى والأوضح
تدخل مطعماً وتجلس في الطاولة. أنت لا تدخل المطبخ بنفسك لتُحضر طعامك — لأنك لا تعرف كيف تطبخ، والمطبخ ليس مكانك. بدلاً من ذلك، تقرأ القائمة وتطلب من النادل: "أريد بيتزا مارغريتا". النادل يأخذ طلبك إلى المطبخ، الطباخ يُحضرها، ثم النادل يعيدها لك على طبق.
تشبيه المترجم الفوري
أنت تتكلم العربية فقط، وطرف آخر يتكلم الإنجليزية فقط. تريد أن تطلب منه شيئاً لكن لا تستطيع التواصل مباشرة. المترجم الفوري يجلس بينكما: يستمع لك بالعربية، يُترجم للإنجليزية، يوصل الرسالة، ثم يترجم الرد بالعربية إليك. API تفعل نفس الشيء لكن بين الأنظمة — نظام يتكلم "بايثون" ونظام آخر يتكلم "جافا سكريبت"، والـ API تُترجم بينهما.
6 أمثلة حقيقية: API في تطبيقات تستخدمها يومياً
تطبيق الطقس لا يعرف الطقس بنفسه — يرسل طلباً لخادم بيانات الطقس عبر API ويستلم درجة الحرارة والرطوبة والرياح.
{
"name": "Riyadh",
"main": {
"temp": 42.5,
"humidity": 12,
"feels_like": 40
},
"weather": [
{ "description": "صافٍ" }
]
}
عندما تبحث في يوتيوب عن "شرح API"، التطبيق لا يبحث في جهازك — يرسل استعلام البحث لخادم يوتيوب عبر API ويعرض لك النتائج.
{
"items": [
{
"id": { "videoId": "dQw4w9WgXcQ" },
"snippet": {
"title": "ما هو API؟ شرح مبسط",
"channelTitle": "TechMind360"
}
}
]
}
عندما تدفع في أي موقع تجاري، الموقع لا يتعامل مع بطاقتك مباشرة — يرسل بيانات الدفع لشركة مثل Stripe عبر API، وStripe تُعالج العملية وترجع "ناجح" أو "مرفوض".
{
"amount": 5000,
"currency": "sar",
"description": "طلب #1234"
}
{
"id": "pi_3xyz...",
"status": "succeeded",
"amount": 5000,
"currency": "sar"
}
عندما تفتح خرائط جوجل وتطلب "اتجاهات من الرياض لجدة"، التطبيق يرسل الطلب لخادم جوجل عبر API ويعيد لك المسار والوقت والمسافة.
{
"routes": [{
"legs": [{
"distance": { "text": "948 كم" },
"duration": { "text": "8 ساعات 45 دقيقة" },
"start_address": "الرياض، السعودية",
"end_address": "جدة، السعودية"
}]
}]
}
عندما تتلقى رسالة تلقائية من متجر على واتساب ("شكراً لطلبك!") — المتجر لم يرسلها يدوياً. نظام المتجر أرسلها عبر WhatsApp Business API تلقائياً عند تأكيد الطلب.
{
"messaging_product": "whatsapp",
"to": "966500000000",
"type": "template",
"template": {
"name": "order_confirmation",
"language": { "code": "ar" }
}
}
{
"messaging_product": "whatsapp",
"contacts": [{ "input": "966500000000" }],
"messages": [{ "id": "wamid.HBgM..." }]
}
عندما تستخدم ChatGPT، الواجهة التي تراها ليست ChatGPT نفسه — هي مجرد "غلاف" يُرسل رسالتك لخادم OpenAI عبر API ويعرض لك الرد. حتى تطبيقات الطرف الثالث التي تستخدم ChatGPT تفعل نفس الشيء عبر API.
{
"model": "gpt-4o-mini",
"messages": [
{
"role": "user",
"content": "ما هو API؟ شرح في جملة واحدة"
}
]
}
{
"choices": [{
"message": {
"role": "assistant",
"content": "API هي وسيط يسمح لتطبيقين بالتواصل وتبادل البيانات بشكل منظم."
}
}]
}
أنواع API: أيها تُستخدم أكثر ولماذا؟
| النوع | كيف يعمل | مثال واقعي | الأفضل لـ |
|---|---|---|---|
| REST | يستخدم HTTP العادي (GET, POST, PUT, DELETE). كل مورد له رابط ثابت. البيانات بتنسيق JSON. | أغلب APIs التي ذكرناها أعلاه — الطقس، يوتيوب، خرائط جوجل | أغلب التطبيقات — المعيار الحالي لـ 85%+ من APIs |
| GraphQL | ترسل "استعلاماً" تحدد فيه بالضبط ماذا تريد من البيانات — لا أكثر ولا أقل. طلب واحد يُرجع بالضبط ما تحتاجه. | GitHub API — تطلب اسم المستخدم فقط فلا يُرسل لك بيانات غير ضرورية | التطبيقات المعقدة التي تحتاج بيانات محددة من مصادر متعددة |
| SOAP | بروتوكول أقدم وأكثر تعقيداً يستخدم XML. أقل شيوعاً الآن لكن لا يزال يُستخدم في الأنظمة المصرفية والحكومية. | أنظمة البنوك القديمة وأنظمة الحكومة — حيث الأمان الصارم مطلوب | الأنظمة القديمة والمؤسسات الكبرى (بنوك، حكومات) |
| WebSocket | اتصال مفتوح ثنائي الاتجاه — لا تحتاج لطلب جديد كل مرة. الخادم يمكنه إرسال بيانات لك دون أن تطلب. | تطبيقات الدردشة (واتساب)، الأسهم المالية الحية، الألعاب المتعددة | التطبيقات التي تحتاج بيانات لحظية ومستمرة (شات، أسهم، ألعاب) |
REST — هو الأكثر انتشاراً وأسهل تعلماً. 85% من الشغل في السوق يحتاج REST فقط. GraphQL وWebSocket تتعلمهما لاحقاً عند الحاجة.
مصطلحات ستقابلها في كل مكان — احفظها
/users أو /users/1. كل مورد له endpoint خاص به.{"name": "أحمد"}🧪 جرّب API حقيقية الآن — بدون أي إعداد
اضغط على الرابط التالي وستجد بيانات مستخدم وهمية بتنسيق JSON — هذا رد حقيقي من خادم حقيقي يعمل الآن. جرّب تغيير الرقم 1 في نهاية الرابط إلى 2 أو 3 وشاهد النتيجة تتغير.
افتح API الآن وشاهد النتيجة ←💡 نصائح لو بدأت بتعلم API فعلاً
اقرأ التوثيق (Documentation) أولاً دائماً
كل API لها صفحة توثيق تشرح كل endpoint وما يقبله ويرجعه. لا تخمن أبداً — التوثيق هو "القائمة" في تشبيه المطعم. ابدأ دائماً من هناك.
استخدم Postman لاختبار APIs بدون كتابة كود
Postman أداة مجانية تتيحك تُرسل طلبات API وتشاهد الردود بشكل مرئي واضح — بدون كتابة أي كود. مثالية للتعلم والاختبار قبل البدء بالبرمجة.
لا تضع مفاتيح API في كودك أبداً
مفتاح API مثل كلمة مرورك — لو وُضع في الكود ونُشر على GitHub، أي شخص يمكنه استخدامه. استخدم ملفات بيئة (ENV) أو متغيرات سرية.
تعلّم تقرأ Status Codes — ستُوفر عليك ساعات تصحيح
عندما لا يعمل شيء، أول سؤال: ما كود الحالة؟ 400 تعني خطأ منك (تحقق من الطلب). 401 تعني مشكلة مصادقة (تحقق من المفتاح). 500 تعني خطأ من الخادم (ليس خطأك).
🎯 الخاتمة
API ليست مفهوماً معقداً كما تبدو — هي ببساطة طريقة منظمة لتطبيقين يتحدثان مع بعضهما. كل مرة تستخدم فيها تطبيقاً يعرض بيانات من مكان آخر — هناك API تعمل في الخلفية. فهم هذا المفهوم يفتح لك باباً كاملاً: بناء تطبيقات تستهلك بيانات حقيقية، أتمتة مهام، وربما بناء API خاصة بك. ابدأ بالتشبيهات، ثم جرّب الرابط الحي أعلاه، ثم حمّل Postman وابدأ اللعب.
❓ الأسئلة الشائعة (FAQ)
ما الفرق بين API وSDK؟
API هي "الطريق" الذي يسمح لبرنامجين بالتواصل — مجرد قنوات اتصال.
SDK (Software Development Kit) هي "مجموعة أدوات" تسهّل استخدام الـ API — تحتوي على كود جاهز، مكتبات، وثائق، وأمثلة. مثال: stripe-python هو SDK يسهّل استخدام Stripe API بلغة بايثون. SDK يختصر عليك كتابة كود من الصفر.
هل API آمنة؟ هل يمكن اختراق بياناتي عبرها؟
API نفسها ليست آمنة أو غير آمنة — الأمان يعتمد على كيفية تطبيقها. API الجيدة تستخدم: HTTPS (تشفير البيانات أثناء النقل)، مصادقة (Authentication)، حدود معدل (Rate Limiting)، وتحقق من المدخلات. إذا كانت API تتبع معايير الأمان الصحيحة فهي آمنة جداً — أغلب APIs الكبرى (Google، Stripe، GitHub) آمنة للغاية.
هل أحتاج أن أكون مبرمجاً لأستخدم API؟
لاستخدامها: لا — رابط jsonplaceholder.typicode.com/users/1 في هذا المقال هو API حقيقية استخدمتها بمجرد فتح رابط في المتصفح. يمكنك أيضاً استخدام Postman بدون أي كود.
لبناء تطبيقات تستخدمها: نعم — ستحتاج معرفة أساسيات لغة برمجة (بايثون الأفضل للمبتدئين) لترسل الطلب وتعالج الرد برمجياً.
هل API مجانية أم مدفوعة؟
الاثنان معاً. أغلب APIs تقدم خطة مجانية بحدود معقولة:
• OpenWeatherMap: مجاني حتى 60 طلب/دقيقة
• OpenAI: مجاني مع رصيد ابتدائي
• Google Maps: مجاني حتى 200$ شهرياً من الاستخدام
• Stripe: مجاني بالكامل — يأخذ عمولة فقط عند إتمام عملية دفع فعلية
الخطة المجانية عادة كافية للتعلم والمشاريع الصغيرة. تدفع فقط عندما يكبر مشروعك.
ما هو الفرق بين GET و POST؟ ومتى أستخدم كل واحدة؟
GET: تطلب بيانات من الخادم. لا تُرسل بيانات حساسة. يمكن حفظ الرابط وإرساله لشخص آخر. مثال: جلب بيانات مستخدم، البحث عن فيديو، معرفة الطقس.
POST: تُرسل بيانات للخادم لإنشاء شيء جديد أو تنفيذ عملية. البيانات في "الجسم" (Body) وليست في الرابط. مثال: إرسال رسالة، إنشاء طلب دفع، رفع صورة.
القاعدة البسيطة: تريد جلب بيانات؟ GET. تريد إرسال بيانات أو تنفيذ عملية؟ POST.
🚀 الخطوة التالية: بناء شيء حقيقي
الآن أنت تفهم ما هي API — الخطوة التالية هي بناء تطبيق صغير يستخدم API حقيقية. حمّل Postman، اختر أي API مجانية من المقال، وابدأ بإرسال طلباتك الأولى. التعلم الحقيقي يبدأ عندما تُجرّب بنفسك.
حمّل Postman مجاناً ←
شاركنا رأيك فرأيك يهمنا
هل لديك سؤال حول الشرح؟
اطرحه هنا وسنقوم بالرد عليك في أقرب وقت ممكن.