Найти в Дзене
Ватериус

Открываем API для приёма показаний из ваших «умных домов».

Оглавление

Сервис автоматической отправки показаний счётчиков воды Ватериус уже отправляет данные на 121 сайт. Мы давно хотели распространить нашу работу на другие типы счётчиков.

Тепло и электроэнергия также требуют своевременной передачи. Многие из вас собирают данные в свои «умные дома». Мы открываем возможность отправить данные с любых счётчиков в личный кабинет Ватериуса!

-2

Поддерживаемые типы данных

Холодная вода, Горячая вода, Электричество (1, 2, 3 тарифа), Газ, Отопление, Питьевая вода

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

  1. Авторизируйтесь в личном кабинете: https://account.waterius.ru
  2. Откройте в браузере адрес: https://account.waterius.ru/api/source/add_universal
  3. Отобразиться "ОК".
  4. Вернитесь на вкладку личного кабинета. Перезагрузите её. Увидите новое устройство.
-3

На почту придёт письмо с примером запроса и уникальным ключом.

-4

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

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_type0": 0 — Холодная вода-2
"ch3": 0.3 — м3
"data_type1": 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
-5

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

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

-6

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

-7

Полный перечень сайтов доступен по ссылке: 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'

Заключение

Не все скрипты отправки показаний протестированы на электричестве и тепле, поэтому мы их будем модернизировать по мере появления от вас заявок.

UPD 2024.10.24: Функционал отправки данных от ваших умных домов бесплатный. Отправка показаний на сайты управляющих компаний — всего 49р/месяц за один лицевой счёт. Подробнее по ссылке.

Добавляйтесь к нам в телеграм чат: @waterius_forum

UPD 2023.12.06: изменили адрес сервера на https://
uc.waterius.ru