setCart

استبدل عربة التسوق الحالية للمستخدم أو الضيف. 🔐 تتطلب هذه الطريقة التفويض (أو سياق الضيف).

الوصف

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

Users.setCart(

body*, body.items*

);

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

المخطط

body(required): ICartSet
محتويات عربة التسوق الجديدة. مثال: { items: [{ productId: 1, qty: 2 }] }

body.items(required): ICartItem[]
عناصر عربة التسوق الجديدة.

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

body.items.qty(required): number
كمية المنتج في عربة التسوق.
مثال: 2

أمثلة

مثال بسيط

const response = await Users.setCart({
  items: [{ productId: 1, qty: 2 }],
});

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

{
  "items": [
    {
      "productId": 1,
      "qty": 2,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "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

---