ما هي REST API؟

ما هي API؟

API (Application Programming Interface) واجهة تتيح للبرامج التحدّث مع بعضها. مثلًا، تطبيق الطقس يطلب البيانات من خادم عبر API.

تخيّل الـ API كنادل في مطعم: تطلب منه (request)، يحضر طلبك من المطبخ (الخادم)، ويعود بالنتيجة (response).

الـ APIs في كل مكان: تسجيل الدخول بحساب جوجل، عرض خريطة داخل تطبيق، أو الدفع الإلكتروني — كلها تعمل عبر واجهات برمجية.

ما هي 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 و REST؟ API مفهوم عام لأي واجهة تواصل بين البرامج، بينما REST نمط محدّد لتصميم الـ APIs فوق بروتوكول HTTP.

هل REST API صعبة؟ لا، مفاهيمها الأساسية بسيطة، وتتقنها بسرعة عند بناء أول واجهة تستهلك بيانات حقيقية.

🎯 التالي: استهلاك API من الكود.