trend.get

Описание

integer/array trend.get(object parameters)

Этот метод позволяет получать данные трендов в соответствии с заданными параметрами.

Этот метод доступен пользователям любого типа. Права на вызов этого метода могут быть отозваны в настройках роли пользователя. Дополнительную информацию смотрите в разделе Роли пользователей.

Параметры

(object) Параметры, определяющие желаемый вывод.

Метод поддерживает следующие параметры.

Параметр Тип Описание
itemids ID/array Возвращать только тренды с указанными ID элементов данных.
time_from timestamp Возвращать только значения, которые были собраны после или в указанное время.
time_till timestamp Возвращать только значения, которые были собраны до или в указанное время.
countOutput boolean Подсчитать количество полученных объектов.
limit integer Ограничить количество полученных объектов.
output query Задать свойства объекта Trend, которые должны быть возвращены.

Возвращаемые значения

(целое число/массив) Возвращает либо:

  • · массив объектов;
  • · количество извлеченных объектов, если использовался параметр countOutput.

Примеры

Получение данных трендов элемента данных

Запрос:

{
    "jsonrpc": "2.0",
    "method": "trend.get",
    "params": {
        "output": [
            "itemid",
            "clock",
            "num",
            "value_min",
            "value_avg",
            "value_max"
        ],
        "itemids": [
            "23715"
        ],
        "limit": "1"
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "23715",
            "clock": "1446199200",
            "num": "60",
            "value_min": "0.165",
            "value_avg": "0.2168",
            "value_max": "0.35"
        }
    ],
    "id": 1
}

Источник

CTrend::get() в ui/include/classes/api/services/CTrend.php.