setWishlist

Thay thế danh sách yêu thích của người dùng hiện tại hoặc khách. 🔐 Phương thức này yêu cầu ủy quyền (hoặc ngữ cảnh khách).

Mô tả

Phương thức này thay thế toàn bộ danh sách yêu thích của ngữ cảnh hiện tại - một người dùng đã được ủy quyền hoặc một khách (được xác định qua tiêu đề x-guest-id, xem Chế độ khách) - bằng các mục được cung cấp. Nó trả về một Promise mà khi hoàn thành sẽ trả về đối tượng IWishlistResponse đã được cập nhật.

Users.setWishlist(

body*, body.items*

);

Sơ đồ tham số

Sơ đồ

body(bắt buộc): IWishlistSet
Nội dung danh sách yêu thích mới. Ví dụ: { items: [{ productId: 1 }] }

body.items(bắt buộc): IWishlistItem[]
Các mục danh sách yêu thích mới.

body.items.productId(bắt buộc): number
Định danh sản phẩm.
ví dụ: 1

Ví dụ

Ví dụ tối thiểu

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

Ví dụ phản hồi

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

Sơ đồ phản hồi

Sơ đồ: IWishlistResponse

items: IWishlistItem[]
Các mục trong danh sách yêu thích.

items.productId: number
Định danh sản phẩm.
ví dụ: 1

items.addedAt: string
Ngày ISO khi mục được thêm vào.
ví dụ: "2026-05-30T10:00:00.000Z"

total: number
Tổng số mục trong danh sách yêu thích.
ví dụ: 3

---