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 duy nhất 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*, body.productId*, body.qty*

);

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): number
Định danh sản phẩm.
ví dụ: 1

body.qty(bắt buộc): number
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": 1,
      "qty": 2,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "total": 1
}

Sơ đồ phản hồi

Sơ đồ: ICartResponse

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

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

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

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 giỏ hàng.
ví dụ: 3

---