Для получение товарных рекомендаций от системы Retail Rocket необходимо обратиться к ресурсу, соответствующему типу рекомендаций.
API получения товарных рекомендаций придерживается общих принципов интеграционных API.
Товарные параметры
Параметр stockId требуется для того, чтобы рекомендации содержали только товары в наличии на конкретном складе (регионе). Значение параметра, как и все товарные параметры, должно соответствовать значениям, переданным в Retail Rocket с товарной базой.
Лимит частоты обращения к ресурсам
По умолчанию установлен лимит в 200 обращений в секунду на магазин (partnerId) в целом. Для изменения лимита необходимо обратиться к вашему аккаунт-менеджеру или через форму поддержки в личном кабинете.
Управление кешированием
Вместе с возвращаемыми данными передается http-заголовок Cache-Control, которому необходимо следовать при кешировании полученных данных.
Возвращаемое значение
В случае успешного обращения к любому ресурсу, HTTP-статус будет 200 Ok, а в теле запроса будет возвращена строка, содержащая JSON-объект.
{
"recommendations":
[
{
"productId": <item id> // число или строка, идентификатор продукта
}
]
}
Если рекомендаций по этим параметром нет, то вернётся пустой массив recommendations.