Получение рекомендованных продуктов

Описание

Возвращает рекомендательную выдачу для заданного плейсмента. В запросе нужно передать идентификатор пользователя или сессии, тип субъекта (subject_type), а также placement_id. Для контекстных сценариев можно передать список продуктов или категорий в context.

URL-адрес

POST/catboss/getOffers

Параметры запроса

Тело запроса (JSON):

Параметр	Тип	Пример	Обязательный	Описание
user_id	string	AA123462374	Да	Постоянный идентификатор пользователя
client_id	string	472717435.1765973942	Да	Сессионный идентификатор
subject_type	string	user_id	Да	Тип субъекта: user_id или client_id
placement_id	integer	12	Да	Идентификатор плейсмента
limit	integer	10	Да	Сколько продуктов вернуть
offset	integer	0	Нет	Смещение для постраничной выдачи
context	object	—	Нет	Контекст для подбора рекомендаций
context.offers_ids	array	["sku_1","sku_2"]	Нет	Идентификаторы продуктов, для которых нужны рекомендации
context.categories_ids	array	["cat_1","cat_2"]	Нет	Идентификаторы категорий, для которых нужны рекомендации

Пример запроса

bash

curl -X POST "https://example.com/api/catboss/getOffers" \
  -H "X-MOODREC-API: <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "user_id": "AA123462374",
    "client_id": "472717435.1765973942",
    "subject_type": "user_id",
    "placement_id": 12,
    "limit": 10,
    "offset": 0,
    "context": {
      "offers_ids": ["sku_1", "sku_2"]
    }
  }'

Пример ответа

json

{
    "placement_id": 5,
    "client_id": "1493995421.1771423091",
    "user_id": "",
    "recoms": [
        {
            "offer_id": "487927",
            "campaign_id": 0,
            "alg_id": 100,
            "audience_id": 0
        },
        {
            "offer_id": "486712",
            "campaign_id": 0,
            "alg_id": 100,
            "audience_id": 0
        }
    ]
}

Возвращаемые параметры

Параметр	Тип	Описание
[]	array	Массив элементов выдачи
[].offer_info	string	Строка со списком идентификаторов рекомендованных продуктов