v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB

Product recommendation engine

Create a batch of the third party recommendations

Batch process helps to add multiple third party recommendations in one request. A third party may submit products recommended to a selected customer based on their previous shopping behavior or products recommended based on links to the current content of their shopping cart.

post/third-party-recommendations/batch

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Request body

error_processing1 | 2

The parameter describes the batch method behavior in case of error occurs. Possible values are: 1 - It returns the first error found and rollback all previous changes (this is also the default behavior if the parameter is not set) / 2 - It creates all valid records and creates an error report from failed attempts.

Example request

{
  "third_party_recommendations": [
    {
      "third_party_recommendation_id": "838b73aacb5ac326cec4030c80",
      "customer_id": "8ea6abece4cd0a4ded0a29f093",
      "products": [
        {
          "product_id": "89bdacbffb5c82f2c52cb9ae8f",
          "plu_ids": [
            {
              "list_code": "GLOBAL",
              "code": "abc"
            }
          ]
        }
      ],
      "recommended_product": {
        "product_id": "89bdacbffb5c82f2c52cb9ae8f",
        "plu_ids": [
          {
            "list_code": "GLOBAL",
            "code": "abc"
          }
        ]
      },
      "recommendation_system_id": "89bdac89bdacbfbffb5c82f2c52c",
      "recommendation_system_dataset_id": "89bffb5c82f2c529bdacbfbff",
      "score": 0.87,
      "state": 1,
      "last_change": "2019-01-04 10:31:56"
    }
  ]
}

Response

No Content