Mettre à jour un produit#

Met à jour un produit de manière synchrone. Identifiez le produit à l'aide de productId ou de sku, conjointement avec shopId. Fournissez exactement un identifiant ; les requêtes contenant les deux ou aucun identifiant retournent 400 Bad Request.

http

PATCH https://sdkapi.ideal.house/product-import/products

L'identifiant est distinct de l'objet product. Cela permet à une intégration de localiser un produit par son SKU actuel et de modifier le SKU dans la même requête.

Utilisez productId comme identifiant lors du changement d'un SKU. Cela garde les nouvelles tentatives non ambiguës si la première requête met à jour le SKU mais que sa réponse est perdue.

Corps de la requête#

Champ	Type	Requis	Description
`shopId`	string	Oui	Shop ID fourni par Ideal House.
`productId`	string	Conditionnel	ID de produit à localiser. Requis lorsque `sku` est omis.
`sku`	string	Conditionnel	SKU actuel à localiser. Requis lorsque `productId` est omis.
`product`	object	Oui	Champs à mettre à jour. Incluez au moins un champ.

Champs de produit éditables#

Seuls les champs inclus dans product sont mis à jour.

Champ	Type	Longueur maximale	Description
`sku`	string	120	Nouveau SKU. Il doit rester unique au sein de la boutique.
`externalProductId`	string	120	Identifiant externe du produit.
`groupId`	string	120	Identifiant de groupe de produits.
`collectionId`	string	120	Identifiant de collection de produits.
`name`	string	255	Nom du produit.
`title`	string	255	Titre d'affichage du produit.
`brand`	string	120	Marque du produit.
`productType`	string	120	Type de produit selon votre taxonomie.
`normalizedProductType`	string	40	Type de produit normalisé. Convenez des valeurs prises en charge avec Ideal House.
`category`	string	120	Catégorie du produit.
`style`	string	120	Style du produit.
`color`	string	120	Couleur du produit.
`availability`	string	40	Valeur de disponibilité.
`imageUrl`	string	1,000	URL de l'image source publique HTTP ou HTTPS.
`previewImageUrl`	string	1,000	URL de l'image d'aperçu HTTP ou HTTPS.
`productUrl`	string	1,000	URL de détail du produit HTTP ou HTTPS.
`attributes`	object	—	Attributs du produit. Lorsqu'il est fourni, cet objet remplace l'objet attributs actuel.
`status`	string	—	Statut du produit. Le point de terminaison de mise à jour accepte `active` ou `inactive`.

Les champs suivants sont en lecture seule : id, shopId, productCode, createdAt et updatedAt. Utilisez le point de terminaison de suppression pour définir un produit sur invalid.

Mise à jour par SKU#

json

{
  "shopId": "shop_123",
  "sku": "SKU-10001",
  "product": {
    "name": "Large Gold Wall Mirror",
    "color": "Antique Gold",
    "status": "active"
  }
}

bash

curl --request PATCH \
  'https://sdkapi.ideal.house/product-import/products' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>' \
  --data-raw '{
    "shopId": "shop_123",
    "sku": "SKU-10001",
    "product": {
      "name": "Large Gold Wall Mirror",
      "color": "Antique Gold",
      "status": "active"
    }
  }'

Mise à jour par ID de produit et changement du SKU#

json

{
  "shopId": "shop_123",
  "productId": "product_123",
  "product": {
    "sku": "SKU-10001-NEW",
    "name": "Large Gold Wall Mirror",
    "status": "inactive"
  }
}

Une mise à jour réussie renvoie 200 OK et l'objet produit mis à jour complet. Un produit inactive est conservé et reste disponible via le point de terminaison de liste des produits.