EnrichmentInsightSetups

Enrichment insight setups are used to define insights that are continuously calculated for products, variants or categories in the system. The Enrichment insight setup defines which data is required for an entity to be considered 100% fulfilled for the insight setup in question.

Get all Enrichment Insights

get

#Available from v.3.5.0

Authorizations

ApiKey

AuthorizationstringRequired

Responses

200

OK

application/json

get

/v1/enrichmentinsightsetups

HTTPcURLJavaScriptPython

GET /v1/enrichmentinsightsetups HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "Uid": "8174d299-a76b-4a16-aaa2-bd885bbdd6d5",
    "EntityType": {},
    "Alias": "WebReady",
    "Label": "Ready for web",
    "Setup": [
      {
        "ConfigurationUid": "48e558eb-e90a-4b6b-b1eb-033bad16dd4b",
        "CategoryId": null,
        "RequiredData": [
          {
            "Type": "AttributeInsightsDataReference",
            "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
          },
          {
            "Type": "AttributeInsightsDataReference",
            "DataReference": "d83b20ce-f2ef-4fe1-adff-51867de72f71_NA_NA"
          }
        ]
      }
    ]
  },
  {
    "Uid": "c83a18ac-ecc8-43c5-b5ed-65b4ec115cfd",
    "EntityType": {},
    "Alias": "BasicEnrichment",
    "Label": "Basic sales enrichment",
    "Setup": [
      {
        "ConfigurationUid": "6c57b23d-587c-4970-b0e1-2f5bfbd5b4d7",
        "CategoryId": null,
        "RequiredData": [
          {
            "Type": "AttributeInsightsDataReference",
            "DataReference": "3e5218b1-4808-4d61-b4e0-f4a1b954d5c8_9_NA"
          }
        ]
      }
    ]
  }
]

Create a new Enrichment Insight

post

#Available from v.3.5.0

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

Model defining setup of an enrichment insight

Uidstring · uuidOptional

Unique id of enrichment insight setup

EntityTypeinteger · enumOptional

Enum representing each supported entity type in enrichment insights engine

• 10 = Category: Category reference
• 20 = Product: Product reference
• 30 = Variant: Variant reference
• 50 = VariantGroup: Variant group reference

Possible values:

Aliasstring | nullableOptional

Unique alias of this insight setup

Labelstring | nullableOptional

Presented name of this enrichment insight setup

Responses

200

OK

No content

post

/v1/enrichmentinsightsetups

HTTPcURLJavaScriptPython

POST /v1/enrichmentinsightsetups HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 415

{
  "Uid": "605509df-0db1-4a32-94c1-5042967ef623",
  "EntityType": {},
  "Alias": "WebReady",
  "Label": "Ready for web",
  "Setup": [
    {
      "ConfigurationUid": "48e558eb-e90a-4b6b-b1eb-033bad16dd4b",
      "CategoryId": null,
      "RequiredData": [
        {
          "Type": "AttributeInsightsDataReference",
          "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
        },
        {
          "Type": "AttributeInsightsDataReference",
          "DataReference": "d83b20ce-f2ef-4fe1-adff-51867de72f71_NA_NA"
        }
      ]
    }
  ]
}

200

OK

No content

Update a Enrichment Insight

put

#Available from v.3.5.0

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

Model defining setup of an enrichment insight

Uidstring · uuidOptional

Unique id of enrichment insight setup

EntityTypeinteger · enumOptional

Enum representing each supported entity type in enrichment insights engine

• 10 = Category: Category reference
• 20 = Product: Product reference
• 30 = Variant: Variant reference
• 50 = VariantGroup: Variant group reference

Possible values:

Aliasstring | nullableOptional

Unique alias of this insight setup

Labelstring | nullableOptional

Presented name of this enrichment insight setup

Responses

200

OK

application/json

put

/v1/enrichmentinsightsetups

HTTPcURLJavaScriptPython

PUT /v1/enrichmentinsightsetups HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 415

{
  "Uid": "18c20c73-8379-4747-9284-dc06b4519e81",
  "EntityType": {},
  "Alias": "WebReady",
  "Label": "Ready for web",
  "Setup": [
    {
      "ConfigurationUid": "48e558eb-e90a-4b6b-b1eb-033bad16dd4b",
      "CategoryId": null,
      "RequiredData": [
        {
          "Type": "AttributeInsightsDataReference",
          "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
        },
        {
          "Type": "AttributeInsightsDataReference",
          "DataReference": "d83b20ce-f2ef-4fe1-adff-51867de72f71_NA_NA"
        }
      ]
    }
  ]
}

200

OK

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "EntityType": 10,
  "Alias": "text",
  "Label": "text",
  "Setup": [
    {
      "ConfigurationUid": "123e4567-e89b-12d3-a456-426614174000",
      "CategoryId": 1,
      "RequiredData": [
        {
          "Type": "text",
          "DataReference": "text"
        }
      ]
    }
  ]
}

Delete a Enrichment Insight

delete

#Available from v.3.5.0

Authorizations

ApiKey

AuthorizationstringRequired

Query parameters

uidstring · uuidOptional

Uid of Enrichment Insight to delete

Responses

200

OK

No content

delete

/v1/enrichmentinsightsetups

HTTPcURLJavaScriptPython

DELETE /v1/enrichmentinsightsetups HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

No content

Get a specific Enrichment Insight

get

#Available from v.3.5.0

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

uidstring · uuidRequired

Unique id of Enrichment Insight

Responses

200

OK

application/json

get

/v1/enrichmentinsightsetups/{uid}

HTTPcURLJavaScriptPython

GET /v1/enrichmentinsightsetups/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Uid": "a5b0859b-503f-4d55-a7dd-4b7a2017065d",
  "EntityType": {},
  "Alias": "WebReady",
  "Label": "Ready for web",
  "Setup": [
    {
      "ConfigurationUid": "48e558eb-e90a-4b6b-b1eb-033bad16dd4b",
      "CategoryId": null,
      "RequiredData": [
        {
          "Type": "AttributeInsightsDataReference",
          "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
        },
        {
          "Type": "AttributeInsightsDataReference",
          "DataReference": "d83b20ce-f2ef-4fe1-adff-51867de72f71_NA_NA"
        }
      ]
    }
  ]
}

Get available data references for a specific entity type

get

#Available from v.3.5.0

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

entityTypeinteger · enumRequired

• 10 = Category
• 20 = Product
• 30 = Variant
• 50 = VariantGroup
• 60 = Asset

Possible values:

Query parameters

configurationUidstring · uuidOptional

Uid of configuration (product structure or catalogue) to get available data references for

categoryIdinteger · int32Optional

CategoryId to get data references for

Responses

200

OK

application/json

get

/v1/enrichmentinsightsetups/{entityType}/availabledatareferences

HTTPcURLJavaScriptPython

GET /v1/enrichmentinsightsetups/{entityType}/availabledatareferences HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "Name": "Name (da-DK)",
    "Type": "AttributeInsightsDataReference",
    "DataReference": "f9a52541-5712-406b-b4b6-04a94399e00f_9_NA"
  },
  {
    "Name": "Color",
    "Type": "AttributeInsightsDataReference",
    "DataReference": "d83b20ce-f2ef-4fe1-adff-51867de72f71_NA_NA"
  },
  {
    "Name": "Brand",
    "Type": "AttributeInsightsDataReference",
    "DataReference": "ac6cbf42-fa4f-4f40-a6cf-a7a81af74815_NA_NA"
  }
]