• Главная
  • Документация
  • Цены
  • Партнерам
  • Блог
  • API популярных предложений

    Запрос информации

    Вызов метода из JavaScript

    Для получения списка рекомендаций используйте одну из функций:

    ФункцияОписание метода
    stcl.popularOffersВозвращает массив строк-идентификаторов предложений
    stcl.popularOffersPropsВозвращает массив объектов идентификатор-свойства предложения

    Выполнение функции с параметрами и получение результата:

    stcl.popularOffers({
    	count : 20,
    	rule : "rule",
    	limit : "category=Телефон",
    	mode : "viewed",
    	check : true,
    	offers : ["599728-600","724824-100"]
    }, function(data){
    	// действия с полученной информацией
    }, function(){
    	// действия в случае ошибки
    });
    

    Описание параметров:

    ПараметрОписание
    countМаксимальное количество предложений в ответе, по умолчанию 20
    ruleИмя правила для фильтрации предложений, по умолчанию отсутствует
    limitФильтрация возвращаемых предложений по одному из свойств в формате тип=значение. По умолчанию отсутствует.

    Пример использования:

    limit = "category=Телефон";
    modeРежим выбора товаров. Можно использовать один из режимов:

    ctr – Самые кликабельные товары
    conv – Самые конверсионные товары
    sold – Самые продаваемые товары
    viewed – Самые просматриваемые товары

    Пример использования:

    mode = "sold";
    checkВозвращать только те предложения, данные по которым известны. Позволяет отфильтровать предложения, которые были недавно удалены, но все еще присутствуют в статистике за последние дни.

    Пример использования:

    check = true;
    offersМассив предложений для сортировки. При использовании этого параметра только указанные предложения могут быть возвращены.

    Пример использования:

    offers = ["599728-600","724824-100"];

    Если параметр не определен, то его необходимо заменить на ключевое слово null.

    Вызов метода с серверной стороны

    Список рекомендаций может быть получен GET-запросом на один из следующих URL:

    URLТип запросаОписание метода
    /popular/offersGETВозвращает массив строк-идентификаторов предложений
    /popular/offers/propsGETВозвращает массив объектов идентификатор-свойства предложения

    При вызове данных методов используются следующие параметры запроса:

    ПараметрОписаниеОбязательный
    keyКлюч ресурсаДа
    uidИдентификатор пользователя.Да
    cМаксимальное количество предложений в ответе, по умолчанию 20Нет
    rИмя правила для фильтрации предложений, по умолчанию отсутствуетНет
    lФильтрация возвращаемых предложений по одному из свойств в формате тип=значение. По умолчанию отсутствует.

    Пример использования:

    l=category%3DТелефон
    Нет
    modeРежим выбора товаров. Можно использовать один из режимов:

    ctr – Самые кликабельные товары
    conv – Самые конверсионные товары
    sold – Самые продаваемые товары
    viewed – Самые просматриваемые товары

    Пример использования:

    mode=sold
    Нет
    chkВозвращать только те предложения, данные по которым известны. Позволяет отфильтровать предложения, которые были недавно удалены, но все еще присутствуют в статистике за последние дни.

    Пример использования:

    chk=1
    Нет
    oСписок предложений для сортировки. При использовании этого параметра только указанные предложения могут быть возвращены.

    Пример использования:

    o=599728-600,724824-100
    Нет

    В ответе будет получен JSON-объект, содержащий информацию.

    Результат

    В зависимости от выбранного метода будет получена различная информация по предложениям в виде отсортированного массива.

    Следующие параметры могут присутствовать в ответе.

    ПараметрТипОписание
    offerСтрокаИдентификатор предложения
    propsОбъектСвойства данного предложения