تخطي إلى المحتوى الرئيسي

مرجع API

واجهة API لعناصر القائمة

واجهة API لعناصر القائمة

تتيح لك واجهة API لعناصر القائمة إنشاء عناصر قائمة مطعمك وقراءتها وتحديثها وحذفها. تتطلب جميع نقاط النهاية المصادقة وتعمل على العناصر التابعة لمطعم المستخدم الذي تمت مصادقته.

GET /api/menu-items

استرداد جميع عناصر القائمة لمطعمك.

المصادقة: مطلوبة (رمز Bearer)

الاستجابة (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "name": "Margherita Pizza",
      "description": "Classic pizza with fresh mozzarella and basil",
      "price": 14.99,
      "priceCents": 1499,
      "category": "Mains",
      "photoUrl": "https://...",
      "isActive": true,
      "position": 1,
      "createdAt": "2026-02-01T12:00:00Z",
      "updatedAt": "2026-02-01T12:00:00Z"
    }
  ]
}

POST /api/menu-items

إنشاء عنصر قائمة جديد. يجب رفع الصورة بشكل منفصل عبر نقطة نهاية الرفع، ثم الإشارة إليها بواسطة الرابط.

المصادقة: مطلوبة (رمز Bearer)

جسم الطلب

{
  "name": "Chicken Tikka Masala",
  "description": "Tender chicken in a rich, creamy tomato sauce",
  "price": 16.99,
  "category": "Mains",
  "photoUrl": "https://..."
}

الاستجابة (201 Created)

{
  "success": true,
  "data": {
    "id": "uuid",
    "name": "Chicken Tikka Masala",
    ...
  }
}

PATCH /api/menu-items/[id]

تحديث عنصر قائمة موجود. ضمّن فقط الحقول التي تريد تغييرها.

المصادقة: مطلوبة (رمز Bearer)

جسم الطلب

{
  "price": 17.99,
  "description": "Updated description"
}

الاستجابة (200 OK)

{
  "success": true,
  "data": {
    "id": "uuid",
    "price": 17.99,
    ...
  }
}

DELETE /api/menu-items/[id]

حذف عنصر قائمة نهائيًا مع صورته ونموذج 3D المرتبطين به.

المصادقة: مطلوبة (رمز Bearer)

الاستجابة (200 OK)

{
  "success": true,
  "data": { "deleted": true }
}