الانتقال إلى المحتوى الرئيسي
استخدم فئات القائمة API لعرض التنقل بين الفئات أو الصفحات المقصودة للفئة.
GET /api/public/menu/categories
تتوقع نقطة النهاية هذه حاليًا وجود مفتاح API في سلسلة الاستعلام.

مثال

curl "https://api.plato.ae/api/public/menu/categories?apiKey=$PLATO_API_KEY&includeProducts=true"

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

المعلمةيكتبتقصيرملحوظات
apiKeyخيطمطلوبمفتاح Plato API.
searchخيطلا أحدالبحث عن أسماء الفئات.
slugخيطلا أحدجلب فئة واحدة عن طريق سبيكة بالضبط.
idsقائمة الفاصلةلا أحدجلب معرفات فئة محددة.
sortByخيطcreatedAtname أو createdAt أو updatedAt أو slug.
sortOrderخيطdescasc أو desc.
pageرقم1رقم الصفحة.
limitرقم20الحد الأدنى 1 والحد الأقصى 100.
includeProductsمنطقيةfalseتضمين المنتجات المنشورة تحت كل فئة.

إجابة

{
  "data": [
    {
      "id": "category_123",
      "slug": "burgers",
      "name": {
        "en": "Burgers"
      },
      "description": null,
      "thumbnail": null,
      "smallThumbnail": null,
      "showcase": null,
      "productsCount": 12,
      "products": [
        {
          "id": "product_123",
          "slug": "classic-burger",
          "name": {
            "en": "Classic Burger"
          },
          "priceOptions": [],
          "published": true,
          "soldout": false
        }
      ],
      "createdAt": "2026-06-17T08:20:00.000Z",
      "updatedAt": "2026-06-17T09:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "totalPages": 1,
    "hasMore": false
  }
}
يتم تضمين products فقط عند includeProducts=true.

ملحوظات

  • المنتجات المضمنة هي منتجات منشورة.
  • استخدم includeProducts=false لقوائم التنقل.
  • استخدم includeProducts=true لصفحات الفئات التي تحتاج إلى قائمة المنتجات الأولى على الفور.