setCart

Remplace 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é) - avec les articles fournis. Elle renvoie une promesse qui se résout en l'objet ICartResponse mis à jour.

Users.setCart(

body*

);

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.
exemple:

[{ productId: 1, qty: 2 }]

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

items.qty(obligatoire): 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"

Exemples

Exemple minimal

const response = await Users.setCart({
  items: [{ productId: 1, qty: 2 }],
});

Exemple de réponse

{
  "items": [
    {
      "productId": 2957,
      "qty": 2,
      "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

---