Créer ou mettre à jour des produits (bulk)

POST

https://core.shopimind.com/v1/products

Crée ou met à jour jusqu'à 50 produits en une seule requête. Chaque enregistrement est apparié sur product_id + lang : les produits localisés existants sont mis à jour, les nouveaux sont créés. Chaque variante linguistique est un enregistrement distinct. La validation s'effectue item par item — les items rejetés sont retournés dans rejected_items. À utiliser pour la synchronisation complète du catalogue ; pour des mises à jour partielles privilégier bulkUpdateProducts. Le traitement est asynchrone.

Parameters

Header Parameters

spm-api-key*

[Authentication] Required API key, in the form {prefix}.{secret}.

Type

string

Required

Example"a1b2c3d4.xK9pR2mVn6QwErTyUiOpAsDfGhJkLzXcVbNmQwErTyU"

Pattern

"^[a-zA-Z0-9]{8}\\.[A-Za-z0-9_-]+$"

Request Body

application/json

[

  

{

  

  

"product_id": 1001,

  

  

"shop_id": "shop_id_1",

  

  

"lang": "en",

  

  

"name": "Product name",

  

  

"reference": "ref0001",

  

  

"ean13": "978020137962",

  

  

"description": "This is a product description",

  

  

"description_short": "This is a short product description",

  

  

"link": "https://www.example.com/product_name",

  

  

"image_link": "https://www.example.com/image.jpg",

  

  

"category_ids": [

  

  

  

1

  

  

],

  

  

"manufacturer_id": "manufacturer_id_1",

  

  

"currency": "USD",

  

  

"price": 10.99,

  

  

"price_discount": 9.99,

  

  

"quantity_remaining": 10,

  

  

"is_active": true,

  

  

"created_at": "2023-01-29T14:47:00.000Z",

  

  

"updated_at": "2023-01-29T14:47:00.000Z"

  

}

]

Responses

Objects have been sent to the processing queue. Partially invalid objects are rejected and returned in rejected_items.

Content-Type

application/json

{

  

"statusCode": 200,

  

"sent_count": 5,

  

"rejected_count": 0,

  

"rejected_items": [

  

]

}

POST

https://core.shopimind.com/v1/products

Playground

Headers

spm-api-key*

Body

Samples

Créer ou mettre à jour des produits (bulk) Crée ou met à jour jusqu'à 50 produits en une seule requête. Chaque enregistrement est apparié sur product_id + lang : les produits localisés existants sont mis à jour, les nouveaux sont créés. Chaque variante linguistique est un enregistrement distinct. La validation s'effectue item par item — les items rejetés sont retournés dans rejected_items. À utiliser pour la synchronisation complète du catalogue ; pour des mises à jour partielles privilégier bulkUpdateProducts. Le traitement est asynchrone. POST /v1/products bulkCreateProducts Products spm-api-key [Authentication] Required API key, in the form {prefix}.{secret}. Objects have been sent to the processing queue. Partially invalid objects are rejected and returned in rejected_items. All objects are invalid, or the request body is not an array, or the array exceeds the maximum allowed size Server error - Internal processing failure