2. Public API Explorer
  3. Product Information

Public API: Product Information

Download OpenAPI json
Active
Zurück
Provides various services for requesting product information.
Documentation

Fetch Complete Information of Products V2

Allows to fetch extensive product information in different formats (existence flag, JSON or HTML). Up to 30 products can be requested in a single call.

POST JSON /portals/api/v2/product/data
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
Requests
Description Example
General and product-specific queries.
Content-Type: application/json 
{
  "outputMode": "normal",
  "queries": {
       "product-images": {
        "type": "json",
        "settings": {
            "limit": 5
        }
        },
        "attachments": {
        "type": "json",
        "settings": {
            "hideGroups": true
        }
     }
  },
  "products": [
    {
      "itemNumber": "2186 183",
      "supplierNumber": "WI",
      "queries": {
        "cover": {
          "type": "exists"
        }
      }
    },
    {
      "itemNumber": "2186 183",
      "supplierNumber": "WI",
      "queries": {
      }
    }
  ]
}
Responses
Description Example
200 General and product-specific queries.
Content-Type: application/json 
{
    "success": true,
    "error": false,
    "products": [{
         "productId": "ABC123",
         "supplierNumber": "WI",
         "itemNumber": "2186 183",
         "resolved": true,
         "queries": [
             {
                 "name": "product-images",
                 "error": false,
                 "images": [{
                     "type": "COLORED_IMAGE",
                     "typeName": "Produktbild",
                     "description": null,
                     "filename": "product.png",
                     "iconUrl": "https://oxomi.com/shared-media/epoch/.../oxomi/attachments/other.png",
                     "downloadUrl": "https://oxomi.com/dasd/pd/attachments/.../.../.../product.png",
                     "fingerprint": "ABC123",
                     "fileSize": "189.54 KB",
                     "fileSizeInBytes": 189537
                 }]
             },
             {
                 "name": "attachments",
                 "error": false,
                 "documents": [{
                     "id": "11002077",
                     "name": "Dokument 1",
                     "internalName": "document 1",
                     "brand": "Marke 1",
                     "brandIcon": "http://localhost:9000/assets/images/brand-preview.png",
                     "outdated": false,
                     "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "pages": [
                         {
                             "pageNumber": 1,
                             "pageName": "1",
                             "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                             "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg"
                         }
                     ]
                 }]
             },
             {
                "name": "cover",
                "error": false,
                "exists": true
            }
         ]
     },{
         "productId": "ABC124",
         "supplierNumber": "WI",
         "itemNumber": "2186 184",
         "resolved": true,
         "queries": [
             {
                 "name": "product-images",
                 "error": false,
                 "images": [{
                     "type": "COLORED_IMAGE",
                     "typeName": "Produktbild",
                     "description": null,
                     "filename": "product2.png",
                     "iconUrl": "https://oxomi.com/shared-media/epoch/.../oxomi/attachments/other.png",
                     "downloadUrl": "https://oxomi.com/dasd/pd/attachments/.../.../.../product2.png",
                     "fingerprint": "ABC123",
                     "fileSize": "189.54 KB",
                     "fileSizeInBytes": 189537
                 }]
             },
             {
                 "name": "attachments",
                 "error": false,
                 "documents": [{
                     "id": "11002077",
                     "name": "Dokument 2",
                     "internalName": "document 2",
                     "brand": "Marke 1",
                     "brandIcon": "http://localhost:9000/assets/images/brand-preview.png",
                     "outdated": false,
                     "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "pages": [
                         {
                             "pageNumber": 2,
                             "pageName": "2",
                             "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                             "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg"
                         }
                     ]
                 }]
             }
         ]
    }]
}
400 Missing parameter or malformed request
Content-Type: application/json 
{
    "success": false,
    "error": true,
    "message": "The parameter {missingParameter} must be filled."
}
401 Authentication required but none provided
Content-Type: application/json
403 Invalid authentication or missing permission
Content-Type: application/json
404 Resource not found
Content-Type: application/json
405 Incorrect request method, e.g. GET instead of POST
Content-Type: application/json
500 Unexpected server-side error
Content-Type: application/json

Fetch Complete Information of Products V1

Allows to fetch extensive product information in different formats (existence flag, JSON or HTML). Up to 30 products can be requested by numbering the parameters itemNumber, supplierNumber or productId upwards.

GET JSON /portals/api/v1/product/data
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
gtin1 Specifies the GTIN of the product to search for. Can be used as an alternative to 'itemNumber1'. 12345678901231
itemNumber1 Specifies the item number to search for. Required if no 'productId1' is provided. 2186 183
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
model1 Specifies the model of the product to search for. Can be used as an alternative to 'itemNumber1'. Model 2186 White
productId1 Specifies the product entity ID to search for. Required if no 'itemNumber1' is provided. ABC123
queries Specifies the information to fetch for each product. Provide no suffix for JSON Data, suffix '-html' for rendered HTML and '-exists' for a boolean flag. This parameter could be provided multiple times with one parameter-value-pair for each queried information. See Produktdaten for possible values. attachments-html
queries1 Specifies the information to fetch for a specific product. Provide no suffix for JSON Data, suffix '-html' for rendered HTML and '-exists' for a boolean flag. This parameter could be provided multiple times with one parameter-value-pair for each queried information. attachments-html
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
supplierNumber1 Specifies the number of the supplier of the product to search for. WI
Responses
Description Example
200 Images and document pages for multiple products.
Content-Type: application/json 
{
    "success": true,
    "error": false,
    "products": [{
         "productId": "ABC123",
         "supplierNumber": "WI",
         "itemNumber": "2186 183",
         "resolved": true,
         "queries": [
             {
                 "name": "product-images",
                 "error": false,
                 "images": [{
                     "type": "COLORED_IMAGE",
                     "typeName": "Produktbild",
                     "description": null,
                     "filename": "product.png",
                     "iconUrl": "https://oxomi.com/shared-media/epoch/.../oxomi/attachments/other.png",
                     "downloadUrl": "https://oxomi.com/dasd/pd/attachments/.../.../.../product.png",
                     "fingerprint": "ABC123",
                     "fileSize": "189.54 KB",
                     "fileSizeInBytes": 189537
                 }]
             },
             {
                 "name": "attachments",
                 "error": false,
                 "documents": [{
                     "id": "11002077",
                     "name": "Dokument 1",
                     "internalName": "document 1",
                     "brand": "Marke 1",
                     "brandIcon": "http://localhost:9000/assets/images/brand-preview.png",
                     "outdated": false,
                     "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "pages": [
                         {
                             "pageNumber": 1,
                             "pageName": "1",
                             "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                             "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg"
                         }
                     ]
                 }]
             }
         ]
     },{
         "productId": "ABC124",
         "supplierNumber": "WI",
         "itemNumber": "2186 184",
         resolved: true,
         "queries": [
             {
                 "name": "product-images",
                 "error": false,
                 "images": [{
                     "type": "COLORED_IMAGE",
                     "typeName": "Produktbild",
                     "description": null,
                     "filename": "product2.png",
                     "iconUrl": "https://oxomi.com/shared-media/epoch/.../oxomi/attachments/other.png",
                     "downloadUrl": "https://oxomi.com/dasd/pd/attachments/.../.../.../product2.png",
                     "fingerprint": "ABC123",
                     "fileSize": "189.54 KB",
                     "fileSizeInBytes": 189537
                 }]
             },
             {
                 "name": "attachments",
                 "error": false,
                 "documents": [{
                     "id": "11002077",
                     "name": "Dokument 2",
                     "internalName": "document 2",
                     "brand": "Marke 1",
                     "brandIcon": "http://localhost:9000/assets/images/brand-preview.png",
                     "outdated": false,
                     "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                     "pages": [
                         {
                             "pageNumber": 2,
                             "pageName": "2",
                             "previewUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg",
                             "mediumUrl": "http://localhost:9000/dasd/p/documents/.../.../....jpg"
                         }
                     ]
                 }]
             }
         ]
    }]
}
400 Missing parameter or malformed request
Content-Type: application/json 
{
    "success": false,
    "error": true,
    "message": "The parameter {missingParameter} must be filled."
}
401 Authentication required but none provided
Content-Type: application/json
403 Invalid authentication or missing permission
Content-Type: application/json
404 Resource not found
Content-Type: application/json
405 Incorrect request method, e.g. GET instead of POST
Content-Type: application/json
500 Unexpected server-side error
Content-Type: application/json

Product Availability

Obtains product availability details from manufacturers. Up to 100 items can be requested by numbering the parameters item, quantity and unit upwards.

Documentation

POST JSON /portals/api/v1/products/availability
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
itemNumber1
Required
Item number 2186 183
mode
Required
Mode (cached or live) live
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
quantity1 Item quantity 500
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
supplierNumber1 Supplier number in the partnership WI
unit1 Item unit related to the item quantity PCE
Responses
Description Example
200 Successful response
Content-Type: application/json 
{
  items: [
    {
      "itemNumber": "2186 183",
      "normalizedItemNumber": "2186183",
      "supplierNumber": "WI",
      "requestedQuantity": 500,
      "cached": false,
      "unknownPartner": false,
      "expectedRenewedAvailability": "2022-08-15",
      "unit": "PCE",
      "unitName": "Stück",
      "stock": 1200,
      "stockIndicator": "LOW",
      "stockMessage": "Geringer Bestand: 1.200 Stk",
      "computedStockMessage": "Geringer Bestand: 1.200 Stk",
      "manufacturerStockMessage": "",
      "manufacturingTimeDays": null
    }
  ]
}
400 Missing parameter or malformed request
Content-Type: application/json 
{
    "success": false,
    "error": true,
    "message": "The parameter {missingParameter} must be filled."
}
401 Authentication required but none provided
Content-Type: application/json
403 Invalid authentication or missing permission
Content-Type: application/json
404 Resource not found
Content-Type: application/json
405 Incorrect request method, e.g. GET instead of POST
Content-Type: application/json
500 Unexpected server-side error
Content-Type: application/json

Product Availability

Obtains product availability details from manufacturers. Up to 100 items can be requested.

Documentation

POST XML /portals/api/xml/v1/products/availability
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
mode
Required
Mode (cached or live) live
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
Requests
Description Example
Single item
Content-Type: text/xml 
<items>
  <mode>cached</mode>
  <item>
    <itemNumber>2186 183</itemNumber>
    <supplierNumber>WI</supplierNumber>
    <quantity>500</quantity>
    <unit>PCE</unit>
  </item>
</items>
Responses
Description Example
200 Single item
Content-Type: text/xml 
<items>
   <item>
     <itemNumber>2186 183</itemNumber>
     <normalizedItemNumber>2186183</normalizedItemNumber>
     <supplierNumber>WI</supplierNumber>
     <requestedQuantity>500</requestedQuantity>
     <cached>false</cached>
     <unknownPartner>false</unknownPartner>
     <expectedRenewedAvailability>2022-08-15</expectedRenewedAvailability>
     <unit>PCE</unit>
     <unitName>Stück</unitName>
     <stock>1200</stock>
     <stockIndicator>LOW</stockIndicator>
     <stockMessage>Geringer Bestand: 1.200 Stk</stockMessage>
     <computedStockMessage>Geringer Bestand: 1.200 Stk</computedStockMessage>
     <manufacturerStockMessage/>
     <manufacturingTimeDays/>
   </item>
 </items>
400 Missing parameter or malformed request
Content-Type: text/xml 
<result>
    <success>false</success>
    <error>true</error>
    <message>The parameter {missingParameter} must be filled.</message>
</result>
401 Authentication required but none provided
Content-Type: text/xml
403 Invalid authentication or missing permission
Content-Type: text/xml
404 Resource not found
Content-Type: text/xml
405 Incorrect request method, e.g. GET instead of POST
Content-Type: text/xml
500 Unexpected server-side error
Content-Type: text/xml

Resolve GTIN to Product

Resolves a product from a given GTIN13 or GTIN14.

Documentation

GET JSON /portals/api/v1/products/resolve-gtin
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
gtin
Required
A valid GTIN13 or GTIN14 that should be resolved to a supplier and item number pair. 12345678901231
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
filterCountry The country to filter by. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. de
filterLanguage The language to filter by in case of multi language portals. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. de
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
Responses
Description Example
200 Product resolved
Content-Type: application/json 
{
  "success": true,
  "error": false,
  "resolved": true,
  "supplierNumber": "0815",
  "supplierItemNumber": "PRODUCT-123"
}
200 Product not found
Content-Type: application/json 
{
  "success": true,
  "error": false,
  "resolved": false
}
400 Missing parameter or malformed request
Content-Type: application/json 
{
    "success": false,
    "error": true,
    "message": "The parameter {missingParameter} must be filled."
}
401 Authentication required but none provided
Content-Type: application/json
403 Invalid authentication or missing permission
Content-Type: application/json
404 Resource not found
Content-Type: application/json
405 Incorrect request method, e.g. GET instead of POST
Content-Type: application/json
500 Unexpected server-side error
Content-Type: application/json

Resolve GTIN to Product

Resolves a product from a given GTIN13 or GTIN14.

Documentation

GET XML /portals/api/xml/v1/products/resolve-gtin
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
gtin
Required
A valid GTIN13 or GTIN14 that should be resolved to a supplier and item number pair. 00012345600012
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
filterCountry The country to filter by. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. de
filterLanguage The language to filter by in case of multi language portals. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. de
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
Responses
Description Example
200 Product resolved
Content-Type: text/xml 
<result>
    <success>true</success>
    <error>false</error>
    <resolved>true</itemFound>
    <supplierNumber>0815</supplierNumber>
    <supplierItemNumber>PRODUCT-123</supplierItemNumber>
</result>
200 Product not found
Content-Type: text/xml 
<result>
    <success>true</success>
    <error>false</error>
    <resolved>false</itemFound>
</result>
400 Missing parameter or malformed request
Content-Type: text/xml 
<result>
    <success>false</success>
    <error>true</error>
    <message>The parameter {missingParameter} must be filled.</message>
</result>
401 Authentication required but none provided
Content-Type: text/xml
403 Invalid authentication or missing permission
Content-Type: text/xml
404 Resource not found
Content-Type: text/xml
405 Incorrect request method, e.g. GET instead of POST
Content-Type: text/xml
500 Unexpected server-side error
Content-Type: text/xml

Search Products via Query Text

Allows to search for products based on the same query logic as used in Navigator Pro.

The result can be narrowed by the same filters as Navigator Pro uses, given as the filters object of the payload next to the queries. Each value may be a single value or an array of values.

A filter value is always a technical key, never a display name. A display name is not rejected, it simply matches no product. These filters are supported:

  • brand - the id of a brand. A brand name is not resolved.
  • series - the id or the code of a series. A code is resolved against the filtered brand, or against the portal owner if no brand is filtered.
  • metaclass - an ETIM group or class as a hierarchy vector rather than a plain class code, e.g. metaclass|EG000001>metaclass|EC000123. This is what allows drilling down from a group into its classes.
  • product-group - the id or the code of a product group, resolved like the series.
  • product-type and product-lifecycle-state - only applied if the respective filter is enabled for the portal.
  • FEATURE_<code> - the values of an ETIM feature, several of which are combined with OR.
  • FEATURE_<code>-min and FEATURE_<code>-max - the bounds of a numeric ETIM feature. The number is parsed in the language of the request, so the decimal separator follows it.
  • properties - ETIM feature values regardless of the feature they belong to.
Brand, series, class, product group, type and lifecycle state accept a single value each; a second one is rejected. Feature and property filters accept several.

Features are defined within a class, so a FEATURE_... or properties filter is only applied once a class is known - either from metaclass or recognized within the query text. Without a class it is silently ignored.

For compatibility with the Navigator Pro vocabulary, all of these are alternatively accepted as filters[<name>][] parameters of the query string, which then take precedence.

By default, a query which matches more products than limit is treated as a miss and the next query of the cascade is tried instead - so that a query which is too broad to be useful does not return an arbitrary excerpt of it. Setting truncate to true disables this: the query is accepted as a match, total reports the real number of matches, and only the first limit products are returned.

Setting includeFacets to true adds a facets object to a matched result.

facets.filters lists the brands, product series, ETIM classes and product groups within the result. The code of an entry is the filter name to pass it back as, and the value of a choice is the filter value - so a facet can be applied without translating anything. A facet is omitted if no product of the result carries a value for it, and it is capped at the 25 most frequent choices. Its totalChoices reports how many distinct values the result actually holds, so a value above the number of choices means the listed ones are only the most frequent, not the complete set. Note that a facet whose filter is already applied only reports the selected value, as the result is narrowed to it.

facets.features and facets.properties are only filled once a concrete class is known (either from metaclass or recognized within the query text - an ETIM group alone carries no features); without one they are emitted as empty arrays. facets.features lists the ETIM features of that class which are relevant as a filter, each either as type: "bool" or "choice" with a choices array of value/label/count, or as type: "range" with a min/max (always the external, human-facing value regardless of request locale) and an optional unit. facets.properties lists the boolean ETIM properties of the class with a count each - the code of an entry is the value to put into the properties filter.

Every hit carries the datasheetUrl of its product datasheet in the requested portal, so it does not have to be assembled from the item and supplier number. The field is absent - rather than empty - for a portal which has deep links disabled, and it addresses the product by its normalized item number, which is why it need not match itemNumber character by character.

POST JSON /portals/api/v2/products/search
Parameters
Name Description Example
accessToken
Required
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. d0765f518ff0cab426dbbd6d467c9967
portal
Required
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. 9999999
user
Required
User name john.doe
filterCountry The country to filter by. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. de
filterLanguage The language to filter by in case of multi language portals. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. de
language Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. de
roles Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. Heating,Electronics,Top-Customer
Requests
Description Example
Providing multiple query texts and the filters to narrow the result
Content-Type: application/json 
{
  "limit": 10,
  "queries": [
    "ST.001.A",
    "00012345600012",
    "ST Sanitär Halbeinbauwaschtisch weiß mit Tisch schwarz",
    "ST Sanitär Waschtisch weiß"
  ],
  "filters": {
    "brand": "86AFJJLLCIDDA7AE169EFJP3M4",
    "metaclass": "metaclass|EG000001>metaclass|EC000123",
    "FEATURE_EF002336": ["EV022510", "EV022511"],
    "FEATURE_EF025889-min": 10
  },
  "truncate": false,
  "includeFacets": false
}
Responses
Description Example
200 Result on query match
Content-Type: application/json 
{
    "success": true,
    "error": false,
    "matchedQuery": 0,
    "total": 1,
    "products": [{
         "itemNumber": "ST.001.A",
         "supplierNumber": "1351",
         "gtin": "00012345600012",
         "model": "ST 001 A",
         "previewImageUrl": "https://oxomi.com/dasd/cv/attachments/.../product-image-preview/....jpg",
         "datasheetUrl": "https://oxomi.com/p/9999999/datasheet/1351/st.001.a",
         "brand": {
           "id": "ABC123",
           "name": "ST Sanitär",
           "mediumImageUrl": "https://oxomi.com/dasd/cv/tenants/.../tenant-medium/....jpg"
         },
         "series": {
           "id": "XYZ123",
           "code": "ST-CeramX",
           "name": "ST-CeramX",
           "mediumImageUrl": "https://oxomi.com/dasd/p/series/.../.../....jpg"
         },
         "shortText": "Halbeinbauwaschtisch weiß mit Tisch schwarz",
         "descriptionText": "Ein Halbeinbauwaschtisch von ST Sanitär aus der Serie ST-CeramX. Erhältlich in weiß mit schwarzem Tisch.",
         "marketingText": "Der Halbeinbauwaschtisch ST.001.A von ST Sanitär aus der Serie ST-CeramX überzeugt durch sein modernes Design und die hochwertige Verarbeitung."
     }],
    "facets": {
        "filters": [{
            "code": "brand",
            "label": "Marke",
            "totalChoices": 1,
            "choices": [{"value": "ABC123", "label": "ST Sanitär", "count": 1}]
        }, {
            "code": "metaclass",
            "label": "Produktgruppe",
            "totalChoices": 1,
            "choices": [{"value": "metaclass|EC000123", "label": "Waschtisch", "count": 1}]
        }],
        "features": [{
            "code": "FEATURE_EF002336",
            "label": "Farbe",
            "type": "choice",
            "choices": [{"value": "EV000123", "label": "weiß", "count": 1}]
        }, {
            "code": "FEATURE_EF025889",
            "label": "Breite",
            "type": "range",
            "min": 45.0,
            "max": 100.0,
            "unit": "cm"
        }],
        "properties": [{"code": "FEATURE_EF099999", "label": "Unterbaufähig", "count": 1}]
    }
}
400 Missing parameter or malformed request
Content-Type: application/json 
{
    "success": false,
    "error": true,
    "message": "The parameter {missingParameter} must be filled."
}
401 Authentication required but none provided
Content-Type: application/json
403 Invalid authentication or missing permission
Content-Type: application/json
404 Resource not found
Content-Type: application/json
405 Incorrect request method, e.g. GET instead of POST
Content-Type: application/json
500 Unexpected server-side error
Content-Type: application/json