Запрос на получение списка источников по количеству документов для рубрики: различия между версиями

Материал из База знаний Айкубаз
Перейти к навигации Перейти к поиску
Строка 60: Строка 60:
  
 
<source>
 
<source>
. . .
+
                                    . . .
 
</source>
 
</source>
 
</list>
 
</list>

Версия 13:47, 21 апреля 2015

Запрос возвращает распределение источников по количеству документов.

Запрос необходимо отправлять GET методом.

Адрес запроса: http://service.iqbuzz.ru/actions/api/topSources


Необходимые параметры:

top – количество (наибольших по количеству документов) источников для отображения

rubricId – идентификатор рубрики, для которой надо отобразить список источников

sentiment – значение тональности документов, которые надо отобразить. Может принимать значения: POSITIVE(позитивные), NEGATIVE(негативные), MIXED(смешанные), NEUTRAL(нейтральные), ALL(все) – по умолчанию.

tags – имя тега, по которому надо произвести фильтрацию, можно указывать несколько тегов через ‘;’

timePeriod – временной интервал, за который строится отчет. Может принимать значения:

- ГГГГ-ММ-ДД;ГГГГ-ММ-ДД (интервал)

- LASTDAY (за текущие сутки)

- LASTWEEK (за сегодня и предыдущие 7 дней)

- LASTMONTH (за сегодня и предыдущие 30 дней)

- LASTHALFYEAR (за сегодня и предыдущие полгода)

- LASTYEAR (за сегодня и предыдущие 365 дней)

sortField – поле для сортировки. Может принимать значение DOCCOUNT(по количеству документов), AUTHORSCOUNT (по количеству авторов). Сортировка происходит по убыванию.


Все параметры, кроме rubricId, являются необязательными.


Формат возвращаемого списка:

  <result>

<totalCount>ОБЩЕЕ КОЛИЧЕСТВО ИСТОЧНИКОВ К ВЫВОДУ</totalCount> <list> <source> <name>ИМЯ ИСТОЧНИКА</name> <url>URL ИСТОЧНИКА</url> <docCount>КОЛИЧЕСТВО ДОКУМЕНТОВ ПО ИСТОЧНИКУ</docCount> <authorCount>КОЛИЧЕСТВО АВТОРОВ ПО ИСТОЧНИКУ</authorCount> <percentage>ПРОЦЕНТНОЕ ОТНОШЕНИЕ К КОЛИЧЕСТВУ ДОКУМЕНТОВ ВО ВСЕХ УДОВЛЕТВОРЯЮЩИХ ЗАПРОСУ ИСТОЧНИКАХ</percentage> </source>

<source> <name>ИМЯ ИСТОЧНИКА</name> <url>URL ИСТОЧНИКА</url> <docCount>КОЛИЧЕСТВО ДОКУМЕНТОВ ПО ИСТОЧНИКУ</docCount> <authorCount>КОЛИЧЕСТВО АВТОРОВ ПО ИСТОЧНИКУ</authorCount> <percentage>ПРОЦЕНТНОЕ ОТНОШЕНИЕ К КОЛИЧЕСТВУ ДОКУМЕНТОВ ВО ВСЕХ УДОВЛЕТВОРЯЮЩИХ ЗАПРОСУ ИСТОЧНИКАХ</percentage> </source>

<source>

                                   . . .

</source> </list> </result>