ПланФикс API analitic.getDataByCondition: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
(Новая страница: «Получение данных аналитик по заданному условию. <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request meth…»)
 
Нет описания правки
Строка 48: Строка 48:
     <analiticData>
     <analiticData>
       <key></key>
       <key></key>
      <task>
        <id></id>
      </task>
      <action>
        <id></id>
      </action>
       <itemData>
       <itemData>
         <id></id>
         <id></id>
Строка 89: Строка 95:
|-
|-
|analiticData.key  || int || идентификатор данных ||  
|analiticData.key  || int || идентификатор данных ||  
|-
|analiticData.task.id || int || идентификатор задачи, к которой прикреплена аналитика ||
|-
|analiticData.action.id  || int || идентификатор действия, к которому прикреплена аналитика ||
|-
|-
|analiticData.itemData  ||  || узел описывающие запись с данными в аналитике ||  
|analiticData.itemData  ||  || узел описывающие запись с данными в аналитике ||  

Версия от 08:38, 9 января 2017

Получение данных аналитик по заданному условию.

<?xml version="1.0" encoding="UTF-8"?>
<request method="analitic.getDataByCondition">
  <account></account>
  <sid></sid>
  <analitic>
    <id></id>
  </analitic>
  <filters>
    <filter>
      <field></field>
      <fromDate></fromDate>
      <toDate></toDate>
    </filter>			  
  </filters>
  <pageSize></pageSize>
  <pageCurrent></pageCurrent>
  <signature></signature>
</request>
Название Тип Значение Примечание
sid string(32) ключ сесии выдается в результате прохождения аутентификации
analitic.id int идентификатор аналитики
pageCurrent int страница
pageSize int размер страницы (максимум 100)
filters условия
filter.field int идентификатор поля аналитики по которому делается условие
filter.fromDate DateTime для условия по дате - от даты
filter.toDate DateTime для условия по дате - до даты

Ответ при успешном выполнении запроса:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <analiticDatas>
    <analiticData>
      <key></key>
      <task>
        <id></id>
      </task>
      <action>
        <id></id>
      </action>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
      </itemData>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
      </itemData>
      <!-- ... -->
    </analiticData>
      <key></key>
    <analiticData>
    </analiticData>
    <analiticData>
      <key></key>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
      </itemData>
      <itemData>
        <id></id>
        <name></name>
        <value></value>
      </itemData>
      <!-- ... -->
    </analiticData>
    <!-- ... -->
  </analiticDatas>
</response>
Название Тип Значение Примечание
analiticDatas список запрошенных аналитик
analiticData узел описывающий данные, которые содержит аналитика
analiticData.key int идентификатор данных
analiticData.task.id int идентификатор задачи, к которой прикреплена аналитика
analiticData.action.id int идентификатор действия, к которому прикреплена аналитика
analiticData.itemData узел описывающие запись с данными в аналитике
itemData.id int идентификатор, он равен field.id
itemData.name string имя поля
itemData.value string значение


В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти