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

AuthorizationstringRequired

Responses

200

application/json

get

/v1/enrichmentinsightsetups

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

200

[
  {
    "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

AuthorizationstringRequired

Body

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

post

/v1/enrichmentinsightsetups

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

No content

Update a Enrichment Insight

put

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Body

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

application/json

put

/v1/enrichmentinsightsetups

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

{
  "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

AuthorizationstringRequired

Query parameters

uidstring · uuidOptional

Uid of Enrichment Insight to delete

Responses

200

delete

/v1/enrichmentinsightsetups

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

200

No content

Get a specific Enrichment Insight

get

#Available from v.3.5.0

Authorizations

AuthorizationstringRequired

Path parameters

uidstring · uuidRequired

Unique id of Enrichment Insight

Responses

200

application/json

get

/v1/enrichmentinsightsetups/{uid}

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

200

{
  "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

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

application/json

get

/v1/enrichmentinsightsetups/{entityType}/availabledatareferences

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

200

[
  {
    "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"
  }
]

PreviousDimensions NextExports

Last updated 9 days ago