setWishlist

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

الوصف

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

.setWishlist(

);

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

المخطط

body(required): IWishlistSet
محتويات قائمة الرغبات الجديدة
مثال:

{ items: [{ productId: 1 }] }

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

[{ productId: 1 }]

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

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

أمثلة

مثال بسيط

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

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

{
  "items": [
    {
      "productId": 2957,
      "addedAt": "2026-10-08T10:10:26.690Z"
    }
  ],
  "total": 1
}

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

المخطط: IWishlistResponse

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

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

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

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

---