ما هو الـ API وكيف يعمل HTTP

كل تطبيق حديث تقريبًا يتحدث مع خادم: المتجر يجلب المنتجات، والتطبيق يرسل الطلبات، وتسجيل الدخول يتحقق من كلمة المرور. اللغة المشتركة بينهما هي HTTP، والواجهة التي يقدمها الخادم اسمها API.

الطلب والاستجابة

الـ API (واجهة برمجة التطبيقات) يشبه نادلًا في مطعم: لا تدخل المطبخ بنفسك، بل تطلب من قائمة محددة، والنادل يعود بما طلبت أو يخبرك أن الطبق غير متوفر.

كل تواصل في HTTP طلب واستجابة:

  • الطلب (Request) فيه: الطريقة (Method)، والعنوان (URL)، والترويسات (Headers) مثل نوع البيانات ومفتاح الدخول، وأحيانًا جسم (Body) فيه بيانات.
  • الاستجابة (Response) فيها: كود الحالة (Status Code)، والترويسات، والجسم الذي يحمل النتيجة.

الطرق GET و POST و PUT و DELETE

  • GET /api/tasks: اجلب قائمة المهام.
  • GET /api/tasks/42: اجلب المهمة رقم 42.
  • POST /api/tasks: أنشئ مهمة جديدة (البيانات في الجسم).
  • PUT /api/tasks/42: عدّل المهمة 42. (و PATCH لتعديل جزئي.)
  • DELETE /api/tasks/42: احذفها.

لاحظ أن العنوان يصف «الشيء» (المهام)، والطريقة تصف «الفعل». هذا الأسلوب اسمه REST، وستجده في أغلب الواجهات.

أكواد الحالة

الرقم الأول يخبرك بالفئة:

  • 2xx نجاح: 200 OK، و 201 Created بعد الإنشاء، و 204 No Content بعد الحذف.
  • 4xx خطأ من الطالب: 400 بيانات غير صحيحة، و 401 لم تسجّل الدخول، و 403 ليس لك الحق، و 404 غير موجود، و 429 طلبات كثيرة جدًا.
  • 5xx خطأ في الخادم: 500 خطأ غير متوقع.

اختيار الكود الصحيح جزء من جودة الـ API؛ من يستعمله يعتمد عليه ليعرف ماذا حدث.

صيغة JSON

أغلب الواجهات تتبادل البيانات بصيغة JSON:

{
  "id": 42,
  "title": "تصميم الصفحة الرئيسية",
  "done": false,
  "tags": ["تصميم", "عاجل"],
  "client": { "name": "متجر النور", "wilaya": "سطيف" }
}

تشبه كائنات JavaScript، مع قواعد أصرم: الأسماء بين علامتي تنصيص مزدوجتين دائمًا، ولا تعليقات، ولا فاصلة بعد آخر عنصر.

مهمتك

افتح أدوات المطوّر على أي موقع تستعمله، ومن تبويب Network اختر Fetch/XHR، ثم تصفّح الموقع. اختر ثلاثة طلبات وسجّل لكل منها: الطريقة، والعنوان، وكود الحالة، وشكل البيانات في الاستجابة.