Créer ou mettre à jour des enregistrements de données personnalisées

POST

https://core.shopimind.com/v1/custom-data-records/{id_definition}

Crée ou met à jour un lot d'enregistrements pour la définition id_definition. Quand la définition déclare des unique_keys, les enregistrements correspondant à une combinaison existante sont mis à jour en place ; sinon ils sont insérés. Le traitement est asynchrone.

Champs de relation — Les champs liés à un schéma système (ex. contacts) acceptent deux formats :

• Identifiant direct (legacy) : l'id canonique (ex. id_contact pour contacts) en numérique.
• Objet de résolution { "by": "<identifiant>", "value": <valeur> } : le serveur résout la cible. Pour contacts, by accepte id_contact, email, id_customer (l'id customer de la boutique, mappé vers id_customer_shop). Le serveur stocke l'id canonique ; pas besoin de récupérer id_contact au préalable.

Parameters

Header Parameters

spm-api-key*

[Authentication] Required API key.

Type

string

Required

Pattern

"^[a-zA-Z0-9-]{20,64}$"

Path Parameters

id_definition*

The ID of the custom data definition where the data will be saved or updated.

Type

string

Required

Request Body

application/json

[

  

{

  

  

"user_id": 123,

  

  

"rating": 5

  

},

  

{

  

  

"user_id": 124,

  

  

"rating": 3

  

}

]

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/custom-data-records/{id_definition}

Playground

Headers

spm-api-key*

Variables

Key

Value

id_definition*

Body

Samples

Créer ou mettre à jour des enregistrements de données personnalisées Crée ou met à jour un lot d'enregistrements pour la définition id_definition. Quand la définition déclare des unique_keys, les enregistrements correspondant à une combinaison existante sont mis à jour en place ; sinon ils sont insérés. Le traitement est asynchrone. Champs de relation — Les champs liés à un schéma système (ex. contacts) acceptent deux formats : - Identifiant direct (legacy) : l'id canonique (ex. id_contact pour contacts) en numérique. - Objet de résolution { "by": "<identifiant>", "value": <valeur> } : le serveur résout la cible. Pour contacts, by accepte id_contact, email, id_customer (l'id customer de la boutique, mappé vers id_customer_shop). Le serveur stocke l'id canonique ; pas besoin de récupérer id_contact au préalable. POST /v1/custom-data-records/{id_definition} saveCustomDataRecords Custom data records spm-api-key [Authentication] Required API key. id_definition The ID of the custom data definition where the data will be saved or updated. Array of custom data records to create or update. Each object must include all required fields. 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