API ماهو باختصار

1. معنى API

API هي اختصار لـ Application Programming Interface، أو بالعربي: "واجهة برمجة التطبيقات".
تخيلها كجسر بين برنامجين أو نظامين مختلفين:
هي اللي تسمح لتطبيق أو موقع ويب يستخدم ميزات أو بيانات تطبيق آخر بدون ما يعرف تفاصيله الداخلية.
مثال: لما تستخدم تطبيق الطقس على هاتفك، هو غالبًا ما يجيب البيانات من موقع الطقس عن طريق API.
2. كيف تعمل؟
الـ API عبارة عن مجموعة تعليمات وقواعد تحدد كيف يطلب البرنامج بيانات من برنامج آخر أو يرسل بيانات له.
عادة تكون على شكل روابط URL للويب (HTTP requests) أو مكتبات جاهزة.
مثال مبسط:
GET https://api.weather.com/v1/today?city=Baghdad
الـ API يرجع لك بيانات الطقس في الكويت بصيغة JSON أو XML جاهزة للاستخدام في التطبيق.
3. هل الـ API مهم أم اختياري؟
مهم جدًا إذا كنت تريد أن برامجك تتفاعل مع برامج أو خدمات أخرى.
مثلًا: دمج الدفع الإلكتروني، الخرائط، الطقس، شبكات التواصل، الذكاء الاصطناعي.
اختياري إذا كان برنامجك يعمل بمعزل عن أي خدمة خارجية، وكل شيء داخلي.
مثال: برنامج بسيط لحساب الرياضيات بدون أي اتصال بالإنترنت.
💡 الخلاصة:
الـ API ليس دائمًا ضروري، لكنه أصبح أساسيًا في عالم الإنترنت الحديث لأن أغلب التطبيقات تعتمد على خدمات خارجية للتوسع أو الحصول على بيانات حية.

1. وش معنى API؟
API يعني واجهة برمجة التطبيقات. باختصار، هو جسر يربط بين برنامجين أو موقعين بحيث يقدرون يتواصلون مع بعض بدون ما يعرف كل واحد كيف مبني جوه.
2. مثال واقعي خليجي:
تخيل عندك تطبيق يوريك أسعار البنزين أو الطقس بالكويت. التطبيق ما عنده بيانات بنفسه، فيرسل طلب للجهة المسؤولة عن البيانات (مثل وزارة الكهرباء أو موقع الطقس) عن طريق API، ويرجع له البيانات جاهزة.
3. وش فايدته؟
مهم إذا تبغى برنامجك يتواصل مع خدمات ثانية أو ياخذ بيانات مباشرة من مواقع أو خدمات خارجية.
اختياري إذا برنامجك يشتغل لوحده وما يحتاج بيانات خارجية.
يعني إذا تبغى تسوي تطبيق يوصل لـ “K-Net” أو “STC Pay” أو أي خدمة خليجية، الـ API لازم. إذا بس تطبيق بسيط يشتغل على جهازك، ما تحتاجه.

مثلا : موقع ويب وعندي سكربت معين كيف اربطها بالخدمه ل API ما المتطلبات
1️⃣ تحديد الخدمة والـ API
أول شيء لازم تعرفه:
أي خدمة أو نظام تبغى تتصل فيه (مثلاً خدمة دفع، طقس، أو أي API خارجي).
تقرأ توثيق الـ API (Documentation) لأنه يوضح لك:
شكل الطلب (GET, POST, إلخ).
شكل البيانات المرسلة والمستلمة (JSON عادةً).
أي مفاتيح أمان أو Tokens مطلوبة.
2️⃣ الحصول على مفتاح API (API Key)
معظم الـ APIs الخارجية تطلب مفتاح API لتأكيد أن الموقع أو السكربت عنده صلاحية استخدام الخدمة.
غالباً يكون مفتاح طويل، مثل: abc123xyz456.
تحفظه بسرية وما تحطه مباشرة في السكربت اللي يطلع للمستخدم.
3️⃣ سكربت الطلب (HTTP Request)
يعتمد على لغة البرمجة اللي تستخدمها على موقعك:
مثال بلغة PHP:

<?php
$apiKey = "YOUR_API_KEY";
$url = "https://api.example.com/data?city=Kuwait";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer $apiKey"
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

هنا الموقع يرسل طلب للـ API، يرجع له بيانات بصيغة JSON، ويقدر يعالجها السكربت.
4️⃣ متطلبات أساسية
موقع ويب شغال (PHP, Node.js, Python… أي لغة تدعم HTTP Requests).
اتصال إنترنت على السيرفر.
مفتاح API أو أي بيانات اعتماد أخرى (Username, Token).
فهم نوع الطلب (GET, POST, PUT, DELETE) حسب توثيق الخدمة.
مكتبة في لغتك تتعامل مع HTTP requests (مثل cURL في PHP، requests في Python، axios في Node.js).
5️⃣ نصائح أمان
لا تخزن مفتاح الـ API في ملفات تظهر للمستخدم (مثل ملفات JS مباشرة على الموقع).
إذا تقدر، اجعل السكربت على السيرفر فقط ووسيط بين الموقع والـ API.

خلينا أعطيك أمر حقيقي عملي تسويه في موقعك لو عندك API Key حقيقي (مش "YOUR_API_KEY" وهمي).
مثلاً لو عندك API مفتوح تعطيك بيانات (مثل OpenWeatherMap لجلب الطقس) — هذا مثال حقيقي يستخدم API Key في PHP:
✅ مثال عملي في PHP للـ API الحقيقي (OpenWeatherMap)
سجّل في OpenWeatherMap وخذ مفتاح API (مجاني).
اكتب هذا الكود في ملف .php في موقعك:

<?php
$apiKey = "هنا_تحط_مفتاحك_الحقيقي"; // API Key الحقيقي
$city = "Kuwait"; // المدينة
$url = "https://api.openweathermap.org/data/2.5/weather?q={$city}&appid={$apiKey}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo "الطقس في " . $data['name'] . " اليوم: " . $data['weather'][0]['description'];
?>

🔹 هذا الكود يجلب لك بيانات الطقس من الـ API ويطبع وصف الطقس.
🔹 فكرة curl_init() هنا تستخدم HTTP لطلب البيانات من API.
🔹 القيمة appid={$apiKey} هو المتغير اللي فيه مفتاح الخدمة (أمان ومصرف بيانات).
🛠 خطوات تشغيلها:
افتح حسابك في منصة API اللي تبغى تستخدمها.
خذ الـ API Key (رمز سرّي).
عوّض "هنا_تحط_مفتاحك_الحقيقي" بالمفتاح اللي حصلت عليه.
ارفع الكود على السيرفر وشغّله في المتصفح.
📌 ملاحظات مهمة
✔ بعض APIs تطلب مفتاح في الـ Headers مش في الرابط، زي:

curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer {$apiKey}"
]);

✔ بعض الـ APIs تطلب بيانات أكثر في الرابط (parameters) حسب التوثيق
عملي واقعي يخدمك: API أسعار الذهب والفضة بالكويت أو API أسعار الصرف. هذي تخدم مشاريع ويب حقيقية بدون تعقيد كبير.
خلينا نعطيك مثال حقيقي لأسعار العملات بالكويت من موقع يقدم API مجاني (مثل exchangerate.host
).

مثال عملي PHP لأسعار الدولار مقابل الدينار الكويتي

<?php
$apiKey = ""; // هذا الـ API مجاني، ما يحتاج مفتاح
$baseCurrency = "USD";
$targetCurrency = "KWD";

$url = "https://api.exchangerate.host/latest?base={$baseCurrency}&symbols={$targetCurrency}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

echo "سعر 1 {$baseCurrency} = " . $data['rates'][$targetCurrency] . " {$targetCurrency}";
?>

✅ شرح سريع:
base=USD → العملة الأساسية (الدولار)
symbols=KWD → العملة المستهدفة (الدينار الكويتي)
json_decode يحول البيانات من JSON لمصفوفة PHP لتسهيل استخدامها
لو تشغل هذا الكود على سيرفرك، يطلع لك سعر الدولار مقابل الدينار بالكويت مباشرة.