addCartItem

إضافة عنصر إلى السلة (أو تحديث كمية عنصر موجود). 🔐 تتطلب هذه الطريقة التفويض (أو سياق الضيف).

الوصف

تضيف هذه الطريقة عنصرًا واحدًا إلى سلة التسوق في السياق الحالي - مستخدم مخول أو ضيف (يتم تحديده عبر رأس x-guest-id، انظر وضع الضيف). إذا كان المنتج موجودًا بالفعل في السلة، يتم تحديث كميته. تعيد وعدًا (Promise) يتم حله إلى كائن ICartResponse المحدث.

Users.addCartItem(

body*

);

مخطط المعلمات

المخطط

body(required): ICartAddItem
العنصر المراد إضافته
مثال:

{ productId: 1, qty: 2 }

body.productId(required): number
معرف المنتج.
مثال: 1

body.qty(required): number
الكمية المراد إضافتها.
مثال: 2

أمثلة

مثال بسيط

const response = await Users.addCartItem({ productId: 1, qty: 2 });

مثال على الاستجابة

{
  "items": [
    {
      "productId": 2957,
      "qty": 1,
      "addedAt": "2026-06-07T14:43:29.338Z"
    }
  ],
  "total": 1
}

مخطط الاستجابة

المخطط: ICartResponse

items: ICartItem[]
عناصر السلة.

items.productId: number
معرف المنتج.
مثال: 1

items.qty: number
كمية المنتج في السلة.
مثال: 2

items.addedAt: string
تاريخ ISO عندما تم إضافة العنصر.
مثال: "2026-05-30T10:00:00.000Z"

total: number
إجمالي عدد العناصر في السلة.
مثال: 3

---