setCart

Remplacez le panier de l'utilisateur actuel ou du visiteur. 🔐 Cette méthode nécessite l'autorisation (ou un contexte de visiteur).

Description

Cette méthode remplace l'intégralité du panier du contexte actuel - un utilisateur autorisé ou un visiteur (résolu via l'en-tête x-guest-id, voir Mode invité) - par les articles fournis. Elle renvoie une promesse qui se résout en l'objet ICartResponse mis à jour.

Users.setCart(

body*, body.items*

);

Schéma des paramètres

Schéma

body(obligatoire): ICartSet
Nouveau contenu du panier. Exemple : { items: [{ productId: 1, qty: 2 }] }

body.items(obligatoire): ICartItem[]
Nouveaux articles du panier.

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

body.items.qty(obligatoire): number
Quantité du produit dans le panier.
exemple : 2

Exemples

Exemple minimal

const response = await Users.setCart({
  items: [{ 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

---