ما هي REST API؟ شرح مبسّط لأشهر طريقة تتكلّم بها التطبيقات
📷 Rodrigo Santos · Pexels✦ أهم النقاط
- REST نمط لتصميم واجهات برمجية تستخدم بروتوكول HTTP والموارد المعنونة بـURL.
- الطُرق الأربع الأساسية: GET للقراءة، POST للإنشاء، PUT/PATCH للتعديل، DELETE للحذف.
- الاستجابة عادة بصيغة JSON مع رمز حالة (Status Code) يوضّح نتيجة الطلب.
- REST بلا حالة (Stateless): كل طلب مستقل ويحمل كل ما يلزمه.
REST API (اختصار Representational State Transfer) هي مجموعة من القواعد المتفق عليها التي تتيح لتطبيقين تبادل البيانات عبر الإنترنت. عندما يعرض تطبيق الطقس على هاتفك درجة الحرارة، فهو غالبًا يطلبها من خادم بعيد عبر REST API ويستقبل الرد بصيغة منظّمة. الفكرة أن كل شيء يُعامَل كـمورد (Resource) له عنوان (URL) واضح، مثل /users/42 للمستخدم رقم 42.
تقوم REST على بروتوكول الويب نفسه (HTTP)، وتستخدم طُرقه القياسية للتعبير عن نوع العملية المطلوبة على المورد. هذا ما يجعلها بسيطة ومألوفة لأي مطوّر ويب: نفس الآلية التي يفتح بها المتصفح صفحة هي التي يطلب بها التطبيق بيانات.
🌐 حاسبة وقت التحميل
اعرف كم يستغرق تحميل أي ملف حسب سرعة نتك — فورًا.
الجدول التالي يوضّح الطُرق الأربع الأساسية وما تفعله:
| الطريقة (Method) | الغرض | مثال | آمنة/متكرّرة |
|---|---|---|---|
| GET | قراءة بيانات | جلب قائمة المنتجات | نعم (لا تغيّر شيئًا) |
| POST | إنشاء عنصر جديد | إضافة منتج | لا |
| PUT / PATCH | تعديل عنصر | تحديث سعر منتج | PUT متكرّرة |
| DELETE | حذف عنصر | حذف منتج | متكرّرة |
بعد كل طلب يردّ الخادم بـرمز حالة (Status Code) من ثلاثة أرقام يلخّص النتيجة: 200 نجاح، 201 تمّ الإنشاء، 400 طلب خاطئ، 401 غير مصرّح، 404 غير موجود، 500 خطأ في الخادم. حفظ هذه الرموز الشائعة يوفّر عليك وقتًا طويلًا في فهم أي مشكلة.
من أهم مبادئ REST أنها بلا حالة (Stateless): الخادم لا يتذكّر طلباتك السابقة، فكل طلب يجب أن يحمل كل ما يلزمه (مثل رمز الدخول). هذا يجعل الخدمة أسهل في التوسّع لأن أي خادم يستطيع الردّ على أي طلب دون الحاجة لمعرفة ما سبق. الرد يأتي غالبًا بصيغة JSON لأنها خفيفة وسهلة القراءة للإنسان والآلة.
لتوضيح الصورة: طلب GET https://api.example.com/products/10 يعني «أعطني المنتج رقم 10»، فيردّ الخادم بـ200 ومعه بيانات المنتج بصيغة JSON. لو المنتج غير موجود يردّ 404. بهذه البساطة تُبنى معظم تطبيقات الويب والموبايل الحديثة التي تتكامل مع خدمات خارجية.
الخلاصة: REST API ليست تقنية معقّدة بل اتفاق أنيق على استخدام أدوات الويب الموجودة أصلًا — عناوين وطُرق HTTP ورموز حالة — لتبادل البيانات بطريقة موحّدة يفهمها الجميع.
المصادر
أسامة عبدالعال — مؤسّس «معرفة» وخبير تسويق رقمي وريادة أعمال، وسفير Hootsuite لمنطقة الشرق الأوسط وأفريقيا. يشرف على تحرير محتوى معرفة ومراجعته لضمان دقّته ووضوحه وقيمته الحقيقية للقارئ.