Produits (StoreProduct)

Le module StoreProductModule permet de créer, modifier, lister et supprimer des produits dans votre boutique.

Accès : client.app.store.product

Méthodes

`create`

Crée un nouveau produit avec ses variantes.

Exemple


const response = await client.app.store.product.create({
  appId: "app_id",
  apiKey: "user_api_key",
  name: "T-Shirt Premium",
  description: "Un t-shirt de haute qualité",
  sellerId: "seller_id",
  categoryId: "category_id",
  variants: [
    {
      price: 2500,
      quantity: 100,
      isDefault: true,
      images: [{ url: "https://example.com/image.jpg", imageId: "img_1" }]
    }
  ]
});
 
if (response.success) {
  console.log("Produit créé :", response.data);
}

Paramètres

Champs requis :

appId: ID de l’application
apiKey: Clé API de l’utilisateur
name: Nom du produit
sellerId: ID du vendeur
categoryId: ID de la catégorie
variants: Tableau de variantes (au moins une requise)

Champs optionnels :

description: Description du produit
sku: Code SKU global
status: ACTIVE, DRAFT, ARCHIVED (défaut: ACTIVE)
seoTitle, seoDescription
collectionIds, tagIds, discountIds
attributes: Liste clé/valeur

Réponse

Succès :


{
  "success": true,
  "data": {
    "id": "product_id",
    "name": "T-Shirt Premium",
    // ... détails du produit
  }
}

`list`

Récupère la liste des produits avec pagination, recherche et filtres.

Exemple


const response = await client.app.store.product.list({
  appId: "app_id",
  apiKey: "user_api_key",
  search: "T-Shirt", // Recherche texte (nom, SKU, description...)
  categoryId: "cat_123", // Filtrer par catégorie
  status: "ACTIVE", // Filtrer par statut
  page: 1,
  limit: 20
});

Paramètres

Champs obligatoires :

appId: ID de l’application
apiKey: Clé API de l’utilisateur

Filtres optionnels :

search: Recherche textuelle (string)
ids: Filtrer par liste d’IDs (string[])
categoryId: Filtrer par catégorie (string)
sellerId: Filtrer par vendeur (string)
collectionIds: Filtrer par collections (string[])
tagIds: Filtrer par tags (string[])
status: Filtrer par statut (ACTIVE, DRAFT, ARCHIVED)
page: Numéro de page (défaut: 1)
limit: Nombre d’éléments par page (défaut: 20, max: 100)

Réponse


{
  "success": true,
  "data": [
    { "id": "p1", "name": "Produit 1", ... },
    { "id": "p2", "name": "Produit 2", ... }
  ],
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 20,
    "totalPages": 5
  }
}

`get`

Récupère les détails d’un produit spécifique.

Exemple


const response = await client.app.store.product.get({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "product_id"
});

`update`

Met à jour un produit existant.

Exemple


const response = await client.app.store.product.update({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "product_id",
  name: "T-Shirt Premium V2",
  status: "ARCHIVED"
});

`delete`

Supprime un produit.

Exemple


const response = await client.app.store.product.delete({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "product_id"
});