Моменты представляют набор сущностей с меткой времени, значением и качеством на момент получения от канала этих параметров и записи их в базу данных. Есть два основных способов получения моментов:
1. В формате хранения в БД с указанием диапазона запроса и ID канала |
GET /api/moments/tags/:tagID/start/:rangeStart/ending/:rangeEnd |
Атрибуты ссылки:
Атрибут | Описание атрибута |
tagID | ID канала, моменты которого необходимо получить |
rangeStart | Дата и время начала диапазона в формате ISO 8601 |
rangeEnd | Дата и время конца диапазона в формате ISO 8601 |
2. Сгруппированные по среднему значению на произвольном временном интервале |
POST /api/history/channel |
Запрос должен включать тело с объектом следующего вида:
Атрибут | Описание атрибута |
channelID | ID канала, моменты которого необходимо получить |
starting | Дата и время начала диапазона в формате ISO 8601 |
ending | Дата и время конца диапазона в формате ISO 8601 |
timeStep | Временной интервал диапазона в секундах |
Пример возвращаемого значения:
[ { "channelID": 374106989, "quality": 0, "datetime": "2020-08-10T10:31:35.979+05:00", "value": 0 }, { "channelID": 374106989, "quality": 0, "datetime": "2020-08-10T10:46:55.007+05:00", "value": 0 }, ... ] |
Пример API-запроса на получение последнего момента |