Products

L'objet Product représente un article spécifique que vous vendez, avec des variants pour différentes options telles que la taille ou la couleur.

ENDPOINTS

  • GET api/v2/store/{store_id}/products : Retourne la liste des produits (100 par page).
  • POST api/v2/store/{store_id}/products(BULK) : Crée plusieurs produits en une seule requête. Il faut respecter une taille de batch maximale de 50 produits à la fois.
  • PUT api/v2/store/{store_id}/products (BULK) : Met à jour plusieurs produits en une seule requête.

L'objet Product

Attributs

  • title (string) : Le titre du produit.
  • reference_id (string) : L'identifiant de référence du produit (CMS).
  • description (string) optionnel : La description du produit.
  • image_url (string) : L'URL de l'image du produit.
  • product_type (string) : Le type de produit.
  • variants (array) : Les variants du produit.

Attributs du variant

  • title (string) : Le titre du variant.
  • price (float) : Le prix du variant.
  • currency_code (string) : Le code de devise du variant.
  • reference_id (string) : L'identifiant de référence du variant.
  • image_url (string) : L'URL de l'image du variant.
  • product_type (string) : Le type de produit du variant.
  • tags (array) : Les balises associées au variant.

Exemple de l'objet Product

{
  "title": "Iphone 15",
  "reference_id": "10580",
  "description": "Découvrez l'iPhone 15 : écran OLED 6,1, puce A16 Bionic, appareil photo 48 MP.",
  "image_url": "https://www.iphone15.png",
  "product_type": "Phone",
  "variants": [
    {
      "title": "Iphone 15 - Blanc 512g",
      "price": 2290.00,
      "currency_code": "EUR",
      "reference_id": "10581",
      "image_url": "https://www.iphone15-white-512g.png",
      "product_type": "Phone",
      "tags": ["Blanc", "512g"]
    },
    {
      "title": "Iphone 15 - Noir 512g",
      "price": 2290.00,
      "currency_code": "EUR",
      "reference_id": "10581",
      "image_url": "https://www.iphone15-black-512g.png",
      "product_type": "Phone",
      "tags": ["Noir", "512g"]
    }
  ]
}

Dans cet exemple, le produit est "Iphone 15" et sa référence "10580".

Il a deux variants : "Iphone 15 - Blanc 512g" et "Iphone 15 - Noir 512g", chacun avec sa propre référence, son prix, sa devise, son URL d'image et ses balises.