setWishlist

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

الوصف

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

Users.setWishlist(

body*, body.items*

);

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

المخطط

body(required): IWishlistSet
محتويات قائمة الرغبات الجديدة. مثال: { items: [{ productId: 1 }] }

body.items(required): IWishlistItem[]
عناصر قائمة الرغبات الجديدة.

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

أمثلة

مثال بسيط

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

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

{
  "items": [
    {
      "productId": 1,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "total": 1
}

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

المخطط: IWishlistResponse

items: IWishlistItem[]
عناصر قائمة الرغبات.

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

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

total: number
إجمالي عدد العناصر في قائمة الرغبات.
مثال: 3

---