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

Материал из База знаний Айкубаз
Перейти к навигации Перейти к поиску
(Новая страница: «Запрос возвращает список документов рубрики. Адрес запроса: http://service.iqbuzz.ru/actions/api/documentList…»)
 
 
(не показано 5 промежуточных версий этого же участника)
Строка 7: Строка 7:
 
Формат значения параметра:
 
Формат значения параметра:
  
<pagedList>
+
 
 +
<code>
 +
<pagedList>
 
   <page>'''PAGE_NUMBER'''</page>
 
   <page>'''PAGE_NUMBER'''</page>
 
   <perPage>'''DOC_PER_PAGE'''</perPage>
 
   <perPage>'''DOC_PER_PAGE'''</perPage>
Строка 43: Строка 45:
 
     <direction>SORT_DIRECTION</direction>
 
     <direction>SORT_DIRECTION</direction>
 
   </sorting>
 
   </sorting>
</pagedList>
+
</pagedList>
 +
</code>
  
 
'''PAGE_NUMBER''' – номер страницы, начинается с 0.
 
'''PAGE_NUMBER''' – номер страницы, начинается с 0.
 +
 
'''DOC_PER_PAGE''' – количество документов, которые надо отобразить
 
'''DOC_PER_PAGE''' – количество документов, которые надо отобразить
 +
 
'''RUBRIC_ID''' – идентификатор рубрики, для которой надо отобразить список документов
 
'''RUBRIC_ID''' – идентификатор рубрики, для которой надо отобразить список документов
 +
 
'''SENTIMENT_VALUE''' – значение тональности документов, которые надо отобразить. Может принимать значения: POSITIVE(позитивные), NEGATIVE(негативные), MIXED(смешанные), NEUTRAL(нейтральные), ALL(все) – по умолчанию.
 
'''SENTIMENT_VALUE''' – значение тональности документов, которые надо отобразить. Может принимать значения: POSITIVE(позитивные), NEGATIVE(негативные), MIXED(смешанные), NEUTRAL(нейтральные), ALL(все) – по умолчанию.
 +
 
'''TAG_ID''' – идентификатор тега, по которому надо произвести фильтрацию
 
'''TAG_ID''' – идентификатор тега, по которому надо произвести фильтрацию
 +
 
'''DOC_ID''' – фильтр по заданным идентификаторам документов
 
'''DOC_ID''' – фильтр по заданным идентификаторам документов
 +
 
'''SORT_FIELD''' – название поля для сортировки. Может принимать значение DOCDATE (дата документа), INSERTIONDATE (дата индексации системой IQBuzz)
 
'''SORT_FIELD''' – название поля для сортировки. Может принимать значение DOCDATE (дата документа), INSERTIONDATE (дата индексации системой IQBuzz)
 +
 
'''SORT_DIRECTION''' – ASC (по возрастанию, новые документы в конце), DESC (по убыванию, новые документы вначале)
 
'''SORT_DIRECTION''' – ASC (по возрастанию, новые документы в конце), DESC (по убыванию, новые документы вначале)
 +
  
 
Жирным шрифтом выделены обязательные для запроса параметры.
 
Жирным шрифтом выделены обязательные для запроса параметры.
Строка 60: Строка 71:
 
Формат возвращаемого списка:
 
Формат возвращаемого списка:
  
<searchResult>
+
<searchResult>
 
   <totalCount>ОБЩЕЕ КОЛИЧЕСТВО ДОКУМЕНТОВ, УДОВЛЕТВОРЯЮЩИХ ФИЛЬТРАМ</totalCount>
 
   <totalCount>ОБЩЕЕ КОЛИЧЕСТВО ДОКУМЕНТОВ, УДОВЛЕТВОРЯЮЩИХ ФИЛЬТРАМ</totalCount>
 
   <results>
 
   <results>
Строка 95: Строка 106:
 
     </searchItem>
 
     </searchItem>
 
   </results>
 
   </results>
</searchResult>
+
</searchResult>
  
 
Параметры title и text содержат значения с тегами, которые преобразованы, чтобы не портить XML структуру (“<” = &lt;, “>”=&gt;). Для получения валидного html надо произвести обратное декодирование.
 
Параметры title и text содержат значения с тегами, которые преобразованы, чтобы не портить XML структуру (“<” = &lt;, “>”=&gt;). Для получения валидного html надо произвести обратное декодирование.

Текущая версия на 13:57, 21 апреля 2015

Запрос возвращает список документов рубрики. Адрес запроса: http://service.iqbuzz.ru/actions/api/documentList Запрос необходимо отправлять POST методом. Дополнительный параметр для получения списка документов: reqStr – XML представление объекта, для организации постраничной навигации.

Формат значения параметра:



<pagedList>
 <page>PAGE_NUMBER</page>
 <perPage>DOC_PER_PAGE</perPage>
 <filter>
   <name>RUBRICID</name>
   <type>RUBRICID</type>
   <values>
     <long>RUBRIC_ID</long>
   </values>
 </filter>
 <filter>
   <name>SENTIMENT</name>
   <type>SENTIMENT</type>
   <values>
     <string>SENTIMENT_VALUE</string>
   </values>
 </filter>
 <filter>
   <name>TAGID</name>
   <type>TAGID</type>
   <values>
     <string>TAG_ID</string>
   </values>
 </filter>
 <filter>
  <name>DOCID</name>
  <type>DOCID</type>
  <values>
   <long>DOC_ID_1</long>
   <long>DOC_ID_2</long>
  </values>
 </filter>
 <sorting>
   <fieldName>SORT_FIELD</fieldName>
   <direction>SORT_DIRECTION</direction>
 </sorting>
</pagedList>

PAGE_NUMBER – номер страницы, начинается с 0.

DOC_PER_PAGE – количество документов, которые надо отобразить

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

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

TAG_ID – идентификатор тега, по которому надо произвести фильтрацию

DOC_ID – фильтр по заданным идентификаторам документов

SORT_FIELD – название поля для сортировки. Может принимать значение DOCDATE (дата документа), INSERTIONDATE (дата индексации системой IQBuzz)

SORT_DIRECTION – ASC (по возрастанию, новые документы в конце), DESC (по убыванию, новые документы вначале)


Жирным шрифтом выделены обязательные для запроса параметры.

При отправке запроса количество узлов <filter> может варьироваться, по необходимости. Фильтр TAGID может содержать несколько элементов <string>TAG_ID</string>, для фильтрации по нескольким тегам.

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

<searchResult>
 <totalCount>ОБЩЕЕ КОЛИЧЕСТВО ДОКУМЕНТОВ, УДОВЛЕТВОРЯЮЩИХ ФИЛЬТРАМ</totalCount>
 <results>
   <searchItem>
     <document>
       <id>ИДЕНТИФИКАТОР ДОКУМЕНТА</id>
       <title>РАЗМЕЧЕННОЕ НАЗВАНИЕ ДОКУМЕНТА</title>
       <text>РАЗМЕЧЕННЫЙ ТЕКСТ ДОКУМЕНТА</text>
       <docDate>ДАТА СОЗДАНИЯ ДОКУМЕНТА(пример: 17-02-2012 10:19:40)</docDate>
       <insertionDate>ДАТА ИНДЕКСАЦИИ ДОКУМЕНТА</insertionDate>
       <url>URL ДОКУМЕНТА</url>
       <doctype>ТИП ДОКУМЕНТА (POST,COMMENT,FORUM,MICROBLOG,VIDEO,NEWS,SOCIALNET)</doctype>
       <sentiment>ТОНАЛЬНОСТЬ ДОКУМЕНТА ДЛЯ ВЫБРАННОЙ РУБРИКИ</sentiment>
     </document>
     <docSource>
       <name>ИМЯ БЛОГА</name>
       <url>URL БЛОГА</url>
     </docSource>
     <blogger>
       <name>ИМЯ БЛОГГЕРА</name>
       <nick>ПСЕВДОНИМ БЛОГГЕРА</nick>
       <email>АДРЕС ЭЛЕКТРОННОЙ ПОЧТЫ</email>
       <icq>НОМЕР ICQ</icq>
       <skype>SKYPE ИДЕНТИФИКАТОР БЛОГГЕРА</skype>
       <age>ВОЗРАСТ БЛОГГЕРА</age>
       <geo>МЕСТОПОЛОЖЕНИЕ БЛОГГЕРА</geo>
     </blogger>
     <tags>
       <tag>
         <id>ИДЕНТИФИКАТОР ТЕГА</id>
         <name>НАЗВАНИЕ ТЕГА</name>
       </tag>
     </tags>
   </searchItem>
 </results>
</searchResult>

Параметры title и text содержат значения с тегами, которые преобразованы, чтобы не портить XML структуру (“<” = <, “>”=>). Для получения валидного html надо произвести обратное декодирование.