Данная статья нужна, если у вас свой «умный дом», куда уже подключены счётчики не через Ватериус. Мы сделали API от вас к нам, чтобы вы могли передать показания в Водоканалы по всей России (а их у нас уйма).

Важно: Если у вас есть устройство Ватериус, то вам требуется другая инструкция.

Чтобы ваши счётчики отобразились на нашем сайте необходимо:
1. Зарегистрироваться на сайте account.waterius.ru
2. Добавить «виртуальное устройство», которое может иметь один или несколько счётчиков.

К примеру одно устройство может иметь 2 счётчика холодной воды и 2 счётчика горячей воды. Или три тарифа электроэнергии: пик, полупик, ночь. Количество и тип счётчиков (тарифов) задаётся в сообщении к нашему серверу. Но сначала нужно получить уникальный токен устройства.

Добавление вашего устройства

1. Авторизируйтесь в личном кабинете: https://account.waterius.ru
2. Откройте в браузере адрес: https://account.waterius.ru/api/source/add_universal
   (Ссылка не активна, чтобы случайно не нажать. Каждое нажатие добавляет новое устройство).
3. Отобразиться "ОК".
4. Вернитесь на вкладку личного кабинета. Перезагрузите её. Увидите новое устройство.
5. На вашу электронную почту придёт письмо с примером запроса и уникальным ключом.

Эти данные получились следующим запросом:

 curl -X POST -d '{"ch0": 127.0, "data_type0": 2, "serial0": "", "key": "SECRET", "email": "your_email@mail.ru"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

Сервер хранит 1 последние показания в сутки.

Примеры устройств

Один счётчик воды ХВС

curl -X POST -d '{"ch0": 0.1, "data_type0": 0, "key": "SECRET"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

"ch0": 0.1 — м3
"data_type0": 0 — Холодная вода

Два счётчика воды ГВС и ХВС

curl -X POST -d '{"ch0": 0.1, "data_type0": 0, "ch1": 0.1, "data_type1": 1, "key": "SECRET"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

"ch0": 0.1 — м3
"data_type0": 0 — Холодная вода

"ch1": 0.1 — м3
"data_type1": 1 - Горячая вода

Четыре счётчика воды 2-ГВС и 2-ХВС

curl -X POST -d '{"ch0": 0.1, "data_type0": 0, "ch1": 0.1, "data_type1": 1, "ch2": 0.2, "data_type2": 0, "ch3": 0.3, "data_type3": 1, "key": "SECRET"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

"ch0": 0.1 — м3
"data_type0": 0 — Холодная вода-1

"ch1": 0.1 — м3
"data_type1": 1 - Горячая вода-1

"ch2": 0.2 — м3
"data_type2": 0 — Холодная вода-2

"ch3": 0.3 — м3
"data_type3": 1 - Горячая вода-2

Однотарифный счётчик электричества

curl -X POST -d '{"ch0": 350.0, "data_type0": 2, "key": "SECRET", "email": "your_email@mail.ru"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

"ch0": 350.0 — кВт*ч
"data_type0": 2 — тип Электричество

Двухтарифный счётчик электричества

curl -X POST -d '{"ch0": 350.0, "data_type0": 5, "ch1": 180.0, "data_type1": 6, "key": "SECRET", "email": "your_email@mail.ru"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

"ch0": 350.0 — кВт*ч
"data_type0": 5 — тип Электричество (день)

"ch1": 180.0 — кВт*ч
"data_type1": 6 — тип Электричество (ночь)

Трёхтарифный счётчик электричества

curl -X POST -d '{"ch0": 200.0, "data_type0": 7, "ch1": 300.0, "data_type1": 8, "ch2": 100.0, "data_type2": 6,"key": "SECRET", "email": "your_email@mail.ru"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

"ch0": 200.0 — кВт*ч
"data_type0": 7 — тип Электричество (пик)

"ch1": 300.0 — кВт*ч
"data_type1": 8 — тип Электричество (полупик)

"ch2": 100.0 — кВт*ч
"data_type2": 6 — тип Электричество (ночь)

Отправляем на сайт. Перезагружаем страницу личного кабинета.

Несколько устройств

Если у вас несколько счётчиков, то добавьте 2 устройства на сайт. Вам придёт 2 письма. В каждом из них будет пример запроса и уникальный токен.

Два счётчика воды ГВС и ХВС и электричество

curl -X POST -d '{"ch0": 0.1, "data_type0": 0, "ch1": 0.1, "data_type1": 1, "key": "SECRET_1"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

curl -X POST -d '{"ch0": 350.0, "data_type0": 2, "key": "SECRET_2", "email": "your_email@mail.ru"}' -H "Content-Type: application/json" https://uc.waterius.ru -v

Настройка отправки в управляющую компанию

Нажимаем кнопку «Настройка» напротив устройства

Можно настроить отправку показаний на электронную почту, по СМС и на сайты управляющих компаний/ТСЖ/водоканалов.

Полный перечень сайтов доступен по ссылке: https://waterius.ru/list

Настройка отправки из Умных домов

HomeAssistant

Заботливый пользователь Андрей Л. уже скинул в чат скрипт для добавления в Home Assistant показаний со своего датчика:

rest_command:
send_waterius_energy:
url: https://uc.waterius.ru
method: POST
payload: '{"ch0": {{ states("sensor.total_energy") }}, "data_type0": 2, "key": "apikeyxxxxxxxxxxxxxxxx"}'
content_type: 'application/json'

SprutHub

На сайте wiki.spruthub.ru есть статья: Передача показаний счетчиков в облако Ватериус

Если возникнут вопросы — пишите в наш телеграм чат @waterius_forum.