Показания по объекту
GET запрос
URL https://api.saures.ru/1.0/object/meters
Параметры запроса
| sid uuid4 | идентификатор сессии |
| id int | идентификатор объекта |
| date ISO 8601 | дата/время на которое необходимо вернуть показания. Необязательный параметр. |
| name str | наименование Контроллера |
| model str | модель Контроллера |
| hardware str | версия аппаратуры |
| request_dt ISO 8601 | дата и время последней передачи показаний от Контроллера на сервер |
| readout_dt ISO 8601 | дата и время последних переданных показаний |
| bat 0...100 | остаточный уровень заряда батарей в процентах |
| ssid str | имя беспроводной сети |
| local_ip | локальный ip адрес с которого выходило устройство на связь |
| firmware str | версия прошивки |
| new_firmware str | версия прошивки на которую обновится контроллер при подключении |
| sn str | серийный номер Контроллера |
| rssi str | уровень сигнала беспроводной сети в dB |
| requests str | количество подключений к серверу |
| cap_state bool | состояние крышки |
| power_supply bool | внешнее питание |
| empty_inputs bool | входы не настроены |
| check_hours int | уведомлять при отсутствии связи более, часов |
| last_connection ISO 8601 | дата и время последнего подключения Контроллера |
| last_connection_warning str | текстовое предупреждение о том, что Контроллер не выходил на связь более чем check_hours часов. Контролируется по полю last_connection. Пустое значение, означает что Контроллер своевременно выходит на связь. |
| check_period_display str | период связи |
| log int | период журналирования, мин |
| scan int | период опроса датчиков, сек |
| vol int | отправка по расходу/объему, л |
| send int | период связи, м |
| lic_channels int | лицензии на каналы |
| active bool | статус блокировки Контроллера. В случае блокировки контроллера биллингом, разблокировка происходит автоматически, пополнением баланса тарифа. В противном случае необходимо разбираться с причиной блокировки службой поддержки(некорректная настройка контроллера, ошибки подключенного оборудования и т.д.). |
| nbiot {...}|none|false | параметры NB-IoT
{tariff: данные о пакете услуг,
msisdn: MSISDN,
status: статус sim,
dt: актуальность данных} |
| meters [...] | массив устройств, подключенных к этому Контроллеру
{meter_id: идентификатор устройства,
meter_name: имя устройства,
eirc_num: идентификатор счетчика в ЕИРЦ,
value: значение,
vals: значения по тарифам(пусто если учет однотарифный),
state: состояние(
0 – ошибок нет
1 – обрыв
2 – короткое замыкание
3 – перерасход ресурса в течение заданного промежутка времени
4 – температура/давление опустились ниже нижнего порога
5 – температура/давление поднялись выше верхнего порога
6 – остановка потребления ресурса в течение заданного промежутка времени
7 – ошибка связи или внутренняя неисправность счетчика с цифровым интерфейсом (RS-485/CAN/MBUS)
8 – некорректное значение или выход значения за пределы измеряемого диапазон
9 – воздействие магнитного поля
10 – обратный поток жидкости),
sn: заводской серийный номер,
type: тип устройства,
command:{
type: тип команды,
description: информация о предполагаемом времени срабатывания} } |
| unbound {...} | не привязанные входы
{vals: значения,
type: тип устройства,
state: состояние,
sn: серийный номер устройства} |
Пример
$ http GET https://api.saures.ru/1.0/object/meters sid=="9dfa5889-fcf2-4970-86ab-cfa4937ec6af" id=="358" -v
GET /1.0/object/meters?sid=9dfa5889-fcf2-4970-86ab-cfa4937ec6af&id=358
HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Connection: keep-alive
Host: api.saures.ru
User-Agent: HTTPie/0.9.8
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 8965
Content-Type: application/json; charset=utf-8
Strict-Transport-Security: max-age=31536000
{
"data": {
"sensors": [
{
"active": true,
"bat": 100,
"cap_state": false,
"check_hours": 25,
"check_period_display": "1 час",
"firmware": "4.4.0",
"hardware": "3.5",
"last_connection": "2020-10-30T14:28:01",
"last_connection_warning": null,
"local_ip": "10.0.0.140",
"log": 60.0,
"lic_channels": 10,
"meters": [
{
"approve_dt": null,
"eirc_num": "",
"input": 1,
"meter_id": 30036,
"meter_name": "",
"sn": "123",
"state": {
"name": "Остановка потребления",
"number": 6
},
"type": {
"name": "Холодная вода",
"number": 1
},
"unit": "м³",
"vals": [
1670.04
]
},
{
"approve_dt": null,
"eirc_num": null,
"input": 2,
"meter_id": 5388,
"meter_name": "ГВС геркон",
"sn": "",
"state": {
"name": "Остановка потребления",
"number": 6
},
"type": {
"name": "Горячая вода",
"number": 2
},
"unit": "м³",
"vals": [
773.05
]
},
{
"approve_dt": null,
"eirc_num": null,
"input": 3,
"meter_id": 5389,
"meter_name": "Протечка",
"sn": "",
"state": {
"name": "Ошибок нет",
"number": 0
},
"type": {
"name": "Датчик",
"number": 9
},
"unit": "",
"vals": [
0
]
},
{
"approve_dt": null,
"eirc_num": "",
"input": 4,
"meter_id": 5390,
"meter_name": "Кран управления333",
"sn": "",
"state": {
"name": "Ошибок нет",
"number": 0
},
"type": {
"name": "Шаровой кран",
"number": 6
},
"unit": "",
"vals": [
1
]
}
],
"name": "ДЕМОСТЕНД R1 WROOM 02D",
"nbiot": null,
"new_firmware": null,
"power_supply": false,
"readout_dt": "2020-10-30T14:00:00",
"request_dt": "2020-10-30T14:28:01",
"requests": 1378,
"rssi": "-53",
"scan": 1,
"sn": "B4E62D40C067",
"ssid": "Wi-Fi: SAURES_R1",
"vol": 0
}
]
},
"errors": [],
"status": "ok"
}