Panier (Cart)

Le module panier permet de gérer les paniers d’achat des clients. Les paniers contiennent des articles avec des variantes de produits.

SDK : client.store.cart

Endpoints

Créer un panier

Crée un nouveau panier, optionnellement associé à un client.


POST /app/{appId}/store/cart/create

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API de l’utilisateur
`customerId`	string	Non	ID du client à associer


curl -X POST https://api.applite.ai/app/{appId}/store/cart/create \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "user_api_key",
    "customerId": "customer_id"
  }'

Obtenir un panier

Récupère un panier avec ses articles et détails des variantes.


POST /app/{appId}/store/cart/{id}

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API de l’utilisateur


curl -X POST https://api.applite.ai/app/{appId}/store/cart/{id} \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "user_api_key" }'

Ajouter un article

Ajoute un article au panier. Si la variante existe déjà, la quantité est incrémentée.


POST /app/{appId}/store/cart/{id}/add-item

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API de l’utilisateur
`variantId`	string	Oui	ID de la variante
`productId`	string	Oui	ID du produit
`quantity`	number	Non	Quantité (défaut: 1)


curl -X POST https://api.applite.ai/app/{appId}/store/cart/{id}/add-item \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "user_api_key",
    "variantId": "variant_id",
    "productId": "product_id",
    "quantity": 2
  }'

Réponse


{
  "success": true,
  "data": {
    "id": "cart_id",
    "items": [...]
  }
}

Erreurs

Code	Description
`Product not found`	Produit non trouvé
`Variant not found`	Variante non trouvée
`Cart not found`	Panier non trouvé

Modifier la quantité d’un article

Met à jour la quantité d’un article. Si la quantité est 0, l’article est supprimé.


POST /app/{appId}/store/cart/{id}/update-item

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API de l’utilisateur
`itemId`	string	Oui	ID de l’article
`quantity`	number	Oui	Nouvelle quantité


curl -X POST https://api.applite.ai/app/{appId}/store/cart/{id}/update-item \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "user_api_key",
    "itemId": "item_id",
    "quantity": 3
  }'

Supprimer un article

Supprime un article du panier.


POST /app/{appId}/store/cart/{id}/remove-item

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API de l’utilisateur
`itemId`	string	Oui	ID de l’article à supprimer


curl -X POST https://api.applite.ai/app/{appId}/store/cart/{id}/remove-item \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "user_api_key",
    "itemId": "item_id"
  }'

Calculer les totaux

Calcule le sous-total, le total et le nombre d’articles du panier.


POST /app/{appId}/store/cart/{id}/calculate-totals

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API de l’utilisateur


curl -X POST https://api.applite.ai/app/{appId}/store/cart/{id}/calculate-totals \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "user_api_key" }'