setCart

Thay thế giỏ hàng 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 một ngữ cảnh khách).

Mô tả

Phương thức này thay thế toàn bộ giỏ hàng 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ặt hàng được cung cấp. Nó trả về một Promise mà khi hoàn thành sẽ trả về đối tượng ICartResponse đã được cập nhật.

Users.setCart(

body*, body.items*

);

Sơ đồ tham số

Sơ đồ

body(bắt buộc): ICartSet
Nội dung giỏ hàng mới. Ví dụ: { items: [{ productId: 1, qty: 2 }] }

body.items(bắt buộc): ICartItem[]
Các mặt hàng giỏ hàng mới.

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

body.items.qty(bắt buộc): number
Số lượng sản phẩm trong giỏ hàng.
ví dụ: 2

Ví dụ

Ví dụ tối thiểu

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

Ví dụ phản hồi

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

Sơ đồ phản hồi

Sơ đồ: ICartResponse

items: ICartItem[]
Các mặt hàng trong giỏ hàng.

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

items.qty: number
Số lượng sản phẩm trong giỏ hàng.
ví dụ: 2

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

total: number
Tổng số mặt hàng trong giỏ hàng.
ví dụ: 3

---