تخطَّ إلى المحتوى

🔌 شرح REST APIs

معاملات الاستعلام

الدرس 11 من 25· ⏱ 1 دقائق قراءة

ما هي؟

قيم تُمرَّر في الرابط بعد ? لتعديل سلوك الطلب:

GET /products?category=books&sort=price&page=2&limit=10

الاستخدامات الشائعة

?search=قلم            البحث
?category=books         التصفية
?sort=price&order=asc   الترتيب
?page=2&limit=10        الترقيم
?fields=name,price      اختيار الحقول

القراءة على الخادم (Express)

app.get("/products", (req, res) => {
  const { category, sort, page = 1, limit = 10 } = req.query;
  // طبّق التصفية والترتيب والترقيم...
  res.json({ page: Number(page), items: [] });
});

الإرسال من العميل

const params = new URLSearchParams({ category: "books", page: 2 });
fetch(`/api/products?${params}`);

💡 استخدم معاملات الاستعلام للقراءة (تصفية/ترقيم)، وجسم الطلب للإنشاء/التعديل.

🎯 التالي: بناء API بـ Express.

هل كان هذا الدرس مفيدًا؟