ما هو الـ 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، ثم تصفّح الموقع. اختر ثلاثة طلبات وسجّل لكل منها: الطريقة، والعنوان، وكود الحالة، وشكل البيانات في الاستجابة.