Запрос данных измерительного канала
запрос: entek/api/signal/<канал>?<параметр>=<значение_1>,...
канал - код запрашиваемого параметра, содержится в ответе на запрос "Запрос станций". Формат кода: EnLogic.St<номер станции>.T<тип параметра>.Grp<номер группы>.Id<номер параметра>. Для запроса нескольких параметров формат запроса будет без номера параметра: EnLogic.St<номер станции>.T<тип параметра>.Grp<номер группы>. Вместо этого необходимые идентификаторы передаются в параметрах запроса в переменной ids разделенные ';' (ids=1;2;3.). При этом не будет использовано прореживание точек.
|
имя параметра
|
описание
|
допустимые значения
|
|
since
|
дата-время начал запрашиваемых данных
|
дата-время в формате ISO8601. Если присутствует только параметр date, запрашиваются данные с указанного момента времени до конца суток. Если присутствует только параметр till, запрашиваются данные с начала суток до указанного момента времени. Если отсутствуют оба параметра, выполняется запрос с параметром till, равным текущему моменту времени. Допускается указание только времени (начиная с 'T'), в этом случае дата считается равной текущей (если дата отсутствует в обоих параметрах) либо равной дате, указанной явно в одном из параметров
|
|
till
|
дата-время конца запрашиваемых данных
|
аналогично параметру since
|
|
point
|
количество требуемых записей
|
При передачи параметра запрашиваемый интервал разбивается на малые и на каждом производится поиск максимального и минимального значения. Если параметр не передавать, то будет возвращено количество записей ограниченное лимитом
|
|
utс
|
сдвиг времени относительно нулевого меридиана
|
вещественное число в диапазоне -12...+12, определяет часовой пояс времени, указанного в параметрах date и till; если utc равен 0, в запросе и ответе сервера используется единое время UTC; если параметр utc отсутствует, в запросе и ответе используется часовой пояс, указанный в конфигурационном файле.
|
|
ids
|
идентификаторы параметров
|
целое положительное число, перечисляются через ';'
|
Пример ответа с одним параметром:
|
{
"data": [
{
"v": 7054.796875,
"t": "2023-01-09T08:28:58.990Z",
"q": 255
},
{
"v": 7054.796875,
"t": "2023-01-09T08:28:59.0Z"
},
{
"v": 7126.419434,
"t": "2023-01-09T08:29:09.0Z"
},
{
"v": 7271.118652,
"t": "2023-01-09T08:29:20.0Z"
}
]
}
|
Пример ответа с несколькими параметрами:
|
{
"params": [
{
"channel": "EnLogic.St0.T222.Grp0.Id61",
"data": [
{
"t": "2024-10-11T08:39:58.9",
"v": 0.519001
},
{
"t": "2024-10-11T08:39:59.0",
"v": 3.563999
},
{
"t": "2024-10-11T08:40:00.0",
"v": 6.575998
}
]
},
{
"channel": "EnLogic.St0.T222.Grp0.Id63",
"data": [
{
"q": 255,
"t": "2024-10-11T08:39:15.990",
"v": 0
},
{
"q": 43,
"t": "2024-10-11T08:39:46.12",
"v": 0
},
{
"t": "2024-10-11T08:39:47.0",
"v": 0.5015
}
]
}
]
}
|
q это quality — признак качества, может принимать следующие значения:
-
0 — достоверное значение в нормальном диапазоне.
-
1, 2, 3, 4 — достоверное значение в диапазонах выхода за границы аварийных и предаварийных уставок
Если значение q < 5, то оно достоверное, если q >=5 — такое значение недостоверное.