addCartItem

Ajoutez un article au panier (ou mettez à jour la quantité d'un article existant). 🔐 Cette méthode nécessite l'autorisation (ou un contexte invité).

Description

Cette méthode ajoute un seul article au panier du contexte actuel - un utilisateur autorisé ou un invité (résolu via l'en-tête x-guest-id, voir Mode invité). Si le produit est déjà dans le panier, sa quantité est mise à jour. Elle renvoie une promesse qui se résout en l'objet ICartResponse mis à jour.

Users.addCartItem(

body*

);

Schéma des paramètres

Schéma

body(obligatoire): ICartAddItem
Article à ajouter
exemple:

{ productId: 1, qty: 2 }

body.productId(obligatoire): number
Identifiant du produit.
exemple: 1

body.qty(obligatoire): number
Quantité à ajouter.
exemple: 2

Exemples

Exemple minimal

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

Exemple de réponse

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

Schéma de réponse

Schéma: ICartResponse

items: ICartItem[]
Articles du panier.

items.productId: number
Identifiant du produit.
exemple: 1

items.qty: number
Quantité du produit dans le panier.
exemple: 2

items.addedAt: string
Date ISO à laquelle l'article a été ajouté.
exemple: "2026-05-30T10:00:00.000Z"

total: number
Nombre total d'articles dans le panier.
exemple: 3

---