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*, body.productId*, body.qty*

);

Paramètres du schéma

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": 1,
      "qty": 2,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "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

---