addWishlistItem

إضافة عنصر إلى قائمة الرغبات. 🔐 تتطلب هذه الطريقة التفويض (أو سياق الضيف).

الوصف

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

Users.addWishlistItem(

body*

);

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

المخطط

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

{ productId: 1 }

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

أمثلة

مثال بسيط

const response = await Users.addWishlistItem({ productId: 1 });

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

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

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

المخطط: IWishlistResponse

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

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

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

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

---