addCartItem

Thêm một mục vào giỏ hàng (hoặc cập nhật số lượng của một mục đã có). 🔐 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 thêm một mục đơn vào 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). Nếu sản phẩm đã có trong giỏ hàng, số lượng của nó sẽ được cập nhật. 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.addCartItem(

body*

);

Sơ đồ tham số

Sơ đồ

body(bắt buộc): ICartAddItem
Mục cần thêm
ví dụ:

{ productId: 1, qty: 2 }

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

body.qty(bắt buộc): số
Số lượng cần thêm.
ví dụ: 2

Ví dụ

Ví dụ tối thiểu

const response = await Users.addCartItem({ productId: 1, qty: 2 });

Ví dụ phản hồi

{
  "items": [
    {
      "productId": 2957,
      "qty": 1,
      "addedAt": "2026-08-14T13:05:01.657Z"
    }
  ],
  "total": 1
}

Sơ đồ phản hồi

Sơ đồ: ICartResponse

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

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

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

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

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

---