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

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

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

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

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

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

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

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

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

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

    limit = "category=Телефон";
    sortПараметры сортировки возвращаемого списка. Состоит из трех компонентов, разделенных символом двоеточие (“:”): имя_параметра:количество:тип.

    имя_параметра – параметр, по которому производится сортировка. Если отсутствует, то вместо сортировки производится перемешивание (shuffle)
    количество – количество первых элементов, которые будут отсортированы.
    тип – тип сортировки: na – числовой, nd – числовой в обратном порядке, sa – строковый, sd – строковый в обратном порядке.

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

    sort = ":20"; // перемешать первые 20 элементов
    sort = "gender:5:nd"; // отсортировать первые 5 элементов по строковому полю gender в обратном порядке.
    checkВозвращать только те предложения, данные по которым известны. Позволяет отфильтровать предложения, которые были недавно удалены, но все еще присутствуют в статистике за последние дни.

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

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

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

    offers = ["599728-600","724824-100"];
    fillДополнить популярными предложениями, если просмотренных предложений (после применения фильтров) меньше запрошенного количества.

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

    fill = true;
    pagesOnlyПоказывать строго только предложения, открытые на отдельной странице подключенного web-сервиса. Пропускать предложения, которые посетитель видел в других местах (каталог, рекомендации).

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

    p = true;

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

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

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

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

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

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

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

    l=category%3DТелефон
    Нет
    sПараметры сортировки возвращаемого списка. Состоит из трех компонентов, разделенных символом двоеточие (“:”): имя_параметра:количество:тип.

    имя_параметра – параметр, по которому производится сортировка. Если отсутствует, то вместо сортировки производится перемешивание (shuffle)
    количество – количество первых элементов, которые будут отсортированы.
    тип – тип сортировки: na – числовой, nd – числовой в обратном порядке, sa – строковый, sd – строковый в обратном порядке.

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

    s=:20 – перемешать первые 20 элементов
    s=gender:5:nd – отсортировать первые 5 элементов по строковому полю gender в обратном порядке.
    Нет
    chkВозвращать только те предложения, данные по которым известны. Позволяет отфильтровать предложения, которые были недавно удалены, но все еще присутствуют в статистике за последние дни.

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

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

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

    o=599728-600,724824-100
    Нет
    fillДополнить популярными предложениями, если просмотренных предложений (после применения фильтров) меньше запрошенного количества.

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

    fill=1
    pПоказывать строго только предложения, открытые на отдельной странице подключенного web-сервиса. Пропускать предложения, которые посетитель видел в других местах (каталог, рекомендации).

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

    p=1

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

    Результат

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

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

    ПараметрТипОписание
    offerСтрокаИдентификатор предложения
    propsОбъектСвойства данного предложения
    scoreЧислоРелевантность - чем выше, тем больше