Product API

Описание

Среднее время обновления YML-файла в системе Retail Rocket - до 3-х часов. Если товарная база обновляется чаще, вы можете использовать product API, которое позволяет передавать информацию о конкретном товаре при посещении пользователем товарной карточки.

Для передачи информации о товарах в платформу Retail Rocket при использовании product API, необходимо вызывать запрос на карточке товара. Отправка запроса, добавляет в систему информацию о конкретном товаре или группе товаров.

📘

Преимущества

Быстрое обновление информации о продуктах.
Информация в базе Retail Rocket будет обновляться как только товар посетит любой пользователь и отправится событие.

Не нужно генерировать XML фид.

Особенности передачи категорий при product API

При передаче товарной базы, посредством product API, дерево товарных категорий будет строиться исходя из переданных значений в параметр "categoryPaths".

Например, при передаче товару значения ["Одежда/Для малышей"], в системе будет сформирована следующая вложенность категорий: "Одежда" -> "Для малышей".

Система будет разбивать категории по символу "/", образуя вложенность.

["Женщины/Одежда/Юбки"] - Женщины -> Одежда -> Юбки

📘

Использование категорий в запросах

В событиях просмотра товарных категорий и запросах рекомендаций, нужно передавать полный путь категории.

Запрос, требующий параметр пути категории, должен получать категорию с учетом полной вложенности.

Если пользователь просмотрел категорию "Юбки", запрос должен принимать значение категории "Женщины/Одежда/Юбки".

Требования и ограничения

Для своевременного обновления информации о товарах, количество пользователей в месяц на сайте должно в 5 раз превышать количество карточек товаров.

Если карточка товара становится недоступна при выходе товара из наличия, то нужно настроить передачу событий о таких товарах с сервера или страницы 404.