ما هي API؟
API (Application Programming Interface) واجهة تتيح للبرامج التحدّث مع بعضها. مثلًا، تطبيق الطقس يطلب البيانات من خادم عبر API.
تخيّل الـ API كنادل في مطعم: تطلب منه (request)، يحضر طلبك من المطبخ (الخادم)، ويعود بالنتيجة (response).
ما هي REST؟
REST نمط معماري لتصميم الـ APIs يعتمد على HTTP. الـ API الذي يتبع هذا النمط يُسمّى RESTful.
المبادئ الأساسية
- الموارد (Resources): كل شيء مورد له رابط (مثل
/users). - بلا حالة (Stateless): كل طلب مستقلّ.
- استخدام طرق HTTP للدلالة على العملية.
نقاط النهاية (Endpoints)
GET /users → جلب كل المستخدمين
GET /users/5 → جلب المستخدم رقم 5
POST /users → إنشاء مستخدم
PUT /users/5 → تعديل المستخدم 5
DELETE /users/5 → حذف المستخدم 5
لاحظ كيف يحدّد فعل HTTP العملية على نفس المورد.
صيغة JSON
البيانات تُتبادَل عادةً بصيغة JSON:
{
"id": 5,
"name": "براء",
"email": "baraa@mail.com"
}
🎯 التالي: استهلاك API من الكود.