ПланФикс API analitic.getData: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) (Новая страница: «Получение данных аналитики прикрепленной действием. Список доступных аналитик получают ...») |
Seva (обсуждение | вклад) Нет описания правки |
||
(не показано 5 промежуточных версий этого же участника) | |||
Строка 18: | Строка 18: | ||
|sid || string(32) ||ключ сесии || выдается в результате прохождения [[ПланФикс API:Аутентификация|аутентификации]] | |sid || string(32) ||ключ сесии || выдается в результате прохождения [[ПланФикс API:Аутентификация|аутентификации]] | ||
|- | |- | ||
| | |analiticKeys.key|| int || идентификатор строки данных аналитики || возвращается функцией [[ПланФикс API action.get|action.get]] | ||
|- | |- | ||
|} | |} | ||
Допускается одним запросом получать данные сразу нескольких добавленных аналитик. Если в запросе был передан идентификатор несуществующей аналитики, то будет возвращена пустая аналитика, ошибка при этом не будет генерироваться. | |||
Ответ при успешном выполнении запроса: | |||
<source lang="xml"> | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<response status="ok"> | |||
<analiticDatas> | |||
<analiticData> | |||
<key></key> | |||
<itemData> | |||
<id></id> | |||
<name></name> | |||
<value></value> | |||
<valueId></valueId> | |||
</itemData> | |||
<itemData> | |||
<id></id> | |||
<name></name> | |||
<value></value> | |||
<valueId></valueId> | |||
</itemData> | |||
<!-- ... --> | |||
</analiticData> | |||
<analiticData> | |||
<key></key> | |||
<itemData> | |||
<id></id> | |||
<name></name> | |||
<value></value> | |||
<valueId></valueId> | |||
</itemData> | |||
<itemData> | |||
<id></id> | |||
<name></name> | |||
<value></value> | |||
<valueId></valueId> | |||
</itemData> | |||
<!-- ... --> | |||
</analiticData> | |||
<!-- ... --> | |||
</analiticDatas> | |||
</response> | |||
</source> | |||
{| class="wikitable" style="margin-top: 1em; width:100% " | |||
!width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание | |||
|- | |||
|analiticDatas || || список запрошенных аналитик || | |||
|- | |||
|analiticData || || узел описывающий данные, которые содержит аналитика || | |||
|- | |||
|analiticData.key || int || идентификатор данных || | |||
|- | |||
|analiticData.itemData || || узел описывающие запись с данными в аналитике || | |||
|- | |||
|itemData.id || int || идентификатор, он равен [[ПланФикс API analitic.getOptions|field.id]] || | |||
|- | |||
|itemData.name || string || имя поля || | |||
|- | |||
|itemData.value || string || значение (строковое представления) || | |||
|- | |||
|itemData.valueId || string || значение (идентификатор для полей, содержащих объект) || | |||
|- | |||
|} | |||
В противном случае будет возвращен ответ с ошибкой: | |||
<source lang="xml"> | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<response status="error"> | |||
<code></code> | |||
</response> | |||
</source> | |||
== Перейти == | |||
*[[ПланФикс API:Аналитика]] | |||
*[[Коды ошибок]] | |||
*[[Список функций]] |
Текущая версия от 13:35, 9 июня 2020
Получение данных аналитики прикрепленной действием. Список доступных аналитик получают из списка действий. Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="analitic.getData">
<account></account>
<sid></sid>
<analiticKeys>
<key></key>
<key></key>
<!-- ... -->
</analiticKeys>
<signature></signature>
</request>
Название | Тип | Значение | Примечание |
---|---|---|---|
sid | string(32) | ключ сесии | выдается в результате прохождения аутентификации |
analiticKeys.key | int | идентификатор строки данных аналитики | возвращается функцией action.get |
Допускается одним запросом получать данные сразу нескольких добавленных аналитик. Если в запросе был передан идентификатор несуществующей аналитики, то будет возвращена пустая аналитика, ошибка при этом не будет генерироваться.
Ответ при успешном выполнении запроса:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<analiticDatas>
<analiticData>
<key></key>
<itemData>
<id></id>
<name></name>
<value></value>
<valueId></valueId>
</itemData>
<itemData>
<id></id>
<name></name>
<value></value>
<valueId></valueId>
</itemData>
<!-- ... -->
</analiticData>
<analiticData>
<key></key>
<itemData>
<id></id>
<name></name>
<value></value>
<valueId></valueId>
</itemData>
<itemData>
<id></id>
<name></name>
<value></value>
<valueId></valueId>
</itemData>
<!-- ... -->
</analiticData>
<!-- ... -->
</analiticDatas>
</response>
Название | Тип | Значение | Примечание |
---|---|---|---|
analiticDatas | список запрошенных аналитик | ||
analiticData | узел описывающий данные, которые содержит аналитика | ||
analiticData.key | int | идентификатор данных | |
analiticData.itemData | узел описывающие запись с данными в аналитике | ||
itemData.id | int | идентификатор, он равен field.id | |
itemData.name | string | имя поля | |
itemData.value | string | значение (строковое представления) | |
itemData.valueId | string | значение (идентификатор для полей, содержащих объект) |
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>