Créer une définition de données personnalisées

POST

https://core.shopimind.com/v1/custom-data-definitions

Crée une définition de données personnalisées — le schéma d'un nouvel objet custom. La définition déclare son name, une description optionnelle, les fields acceptés (colonnes typées), une clé composite unique_keys optionnelle (utilisée par saveCustomDataRecords pour résoudre l'upsert), et des relationships optionnelles reliant un champ source à un schéma système (contacts, products) ou à un autre schéma custom. La définition est créée en statut active. Le name doit être unique. Si une relation omet targetField, le serveur affecte la clé canonique : id pour un schéma custom, id_contact pour contacts, product_id pour products.

Parameters

Header Parameters

spm-api-key*

[Authentication] Required API key.

Type

string

Required

Pattern

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

Request Body

application/json

{

  

"name": "product_ratings",

  

"description": "Tracks customer ratings and feedback for products",

  

"unique_keys": [

  

  

[

  

  

  

"product_id",

  

  

  

"customer_id"

  

  

]

  

],

  

"fields": [

  

  

{

  

  

  

"name": "product_id",

  

  

  

"label": "Product ID",

  

  

  

"type": "number",

  

  

  

"description": "The unique identifier for the product.",

  

  

  

"required": true,

  

  

  

"default": {

  

  

  

},

  

  

  

"options": [

  

  

  

  

[

  

  

  

  

  

"option 1",

  

  

  

  

  

"option 2",

  

  

  

  

  

1,

  

  

  

  

  

2,

  

  

  

  

  

3

  

  

  

  

]

  

  

  

]

  

  

}

  

],

  

"relationships": [

  

  

{

  

  

  

"sourceField": "product_id",

  

  

  

"targetSchemaType": "system",

  

  

  

"targetSchema": "customers",

  

  

  

"targetField": "id_contact"

  

  

}

  

]

}

Responses

Custom data definition created successfully

Content-Type

application/json

{

  

"statusCode": 201,

  

"data": {

  

  

"id_definition": 1,

  

  

"name": "product_ratings",

  

  

"description": "Tracks customer ratings and feedback for products",

  

  

"unique_keys": [

  

  

  

[

  

  

  

  

"product_id",

  

  

  

  

"customer_id"

  

  

  

]

  

  

],

  

  

"fields": [

  

  

  

{

  

  

  

  

"name": "product_id",

  

  

  

  

"label": "Product ID",

  

  

  

  

"type": "number",

  

  

  

  

"description": "The unique identifier for the product.",

  

  

  

  

"required": true,

  

  

  

  

"default": {

  

  

  

  

},

  

  

  

  

"options": [

  

  

  

  

  

[

  

  

  

  

  

  

"option 1",

  

  

  

  

  

  

"option 2",

  

  

  

  

  

  

1,

  

  

  

  

  

  

2,

  

  

  

  

  

  

3

  

  

  

  

  

]

  

  

  

  

]

  

  

  

}

  

  

],

  

  

"relationships": [

  

  

  

{

  

  

  

  

"sourceField": "product_id",

  

  

  

  

"targetSchemaType": "system",

  

  

  

  

"targetSchema": "customers",

  

  

  

  

"targetField": "id_contact"

  

  

  

}

  

  

],

  

  

"status": "active",

  

  

"created_at": "2024-05-17T14:20:19.000Z",

  

  

"updated_at": "2024-05-17T14:20:19.000Z"

  

}

}

POST

https://core.shopimind.com/v1/custom-data-definitions

Playground

Headers

spm-api-key*

Body

Samples

Créer une définition de données personnalisées Crée une définition de données personnalisées — le schéma d'un nouvel objet custom. La définition déclare son name, une description optionnelle, les fields acceptés (colonnes typées), une clé composite unique_keys optionnelle (utilisée par saveCustomDataRecords pour résoudre l'upsert), et des relationships optionnelles reliant un champ source à un schéma système (contacts, products) ou à un autre schéma custom. La définition est créée en statut active. Le name doit être unique. Si une relation omet targetField, le serveur affecte la clé canonique : id pour un schéma custom, id_contact pour contacts, product_id pour products. POST /v1/custom-data-definitions createCustomDataDefinition Custom data definitions spm-api-key [Authentication] Required API key. Custom data definition created successfully Client error - Invalid request or authentication issues Server error - Internal processing failure