sshalyminov / domru

Докер контейнер для интеграции домофона от Domru в Home Assistant

Библиотека для работы с домофоном от domru.ru

Для работы необходим access_token, который можно получить из COOKIES после авторизации в личном кабинете domru.ru

Для получения токена необходимо:

Пример будет реализован на Google Chrome

1. Автоизоваться в личном кабинете https://domru.ru/
2. Открыть Google Chrome Dev Tools
3. Открыть вкладку Console и ввести внизу следующий код

function getCookie(name) {
  let matches = document.cookie.match(new RegExp(
    "(?:^|; )" + name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)"
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
}
getCookie('ACCESS_TOKEN')

4. В ответ Вы получите 30-значный access_token

Именно этот токен необходимо будет использовать для библиотеки

Docker

AMD64 - Intel nuc, etc..

docker run --name lib_domru -d -p 8080:8080 -e ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -e OPERATOR_ID=2 alexmorbo/domru:latest

Raspberry PI

docker run --name lib_domru -d -p 8080:8080 -e ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -e OPERATOR_ID=2 alexmorbo/domru:arm32v7

... Где

• --name lib_domru - имя контейнера
• -p 8080:8080 - порт, по которому будет доступен json api
• -e ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx - токен, полученный ранее
• -e OPERATOR_ID=x - идентификатор конечного оператора.

Известные операторы на данный момент:

• 2 - Санкт-Петербург, Интерзет.ДомРу
• 5 - Волгоград
• 8 - Нижний Новгород
• 10 - Ижевск
• 42 - Уфа

Api

Общая информация

host-ip - IP малины или хост машины, где запущен контейнер, например 192.168.1.20

HTTP GET http://host-ip:8080/

В ответе будет json с следующими параметрами:

• accessToken - текуший accessToken к API domru
• memory - количество памяти, которое использует библотека
• finances - блок с финансовой информацией от API
• cameras - блок с информацией о камерах, которые доступны через приложение и API
• subscriberPlaces - блок с информацией о пользователе, доступных домофонах
• timers - массив с информацией о внутренних таймерах

Открыть дверь через домофон

HTTP GET http://host-ip:8080/open/{placeId}/{accessControlId}

Где:

• placeId - идентификатор места, берется из subscriberPlaces
• accessControlId - идентификатор домофона, берется из subscriberPlaces

Если у вас всего 1 домофон на учетной записи, то передавать placeId и accessControlId не требуется

В ответе будет json следующего вида:

{
    "status": true,
    "errorCode": null,
    "errorMessage": null
}

Получить снепшот с камеры домофона

HTTP GET http://host-ip:8080/video/snapshot/{placeId}/{accessControlId}

Где:

• placeId - идентификатор места, берется из subscriberPlaces
• accessControlId - идентификатор домофона, берется из subscriberPlaces

Если у вас всего 1 домофон на учетной записи, то передавать placeId и accessControlId не требуется

В ответе будет image/jpeg с камеры домофона

Видеопоток с камры домофона

HTTP GET http://host-ip:8080/video/stream/{placeId}/{accessControlId}

Где:

• placeId - идентификатор места, берется из subscriberPlaces
• accessControlId - идентификатор домофона, берется из subscriberPlaces

Если у вас всего 1 домофон на учетной записи, то передавать placeId и accessControlId не требуется

Ответом от сервиса будет перенаправление на ссылку, по которой можно получить видеопоток с камеры

Home Assistant

В HA можно добавить камеру с домофона, а также финансовую информацию и switch для открытия двери.

Натройки в configuration.yaml

sensors:
  - platform: rest
    name: domru_finances
    resource: http://host-ip:8080/
    value_template: '{{ value_json.finances.balance }}'
    scan_interval: 3600
    headers:
      User-Agent: homeassistant

camera:
  - platform: generic
    name: domru_domofon
    still_image_url: http://host-ip:8080/video/snapshot
    stream_source: http://host-ip:8080/video/stream

rest_command:
  domru_open_door:
    url: 'http://host-ip:8080/open'

Пример карточки в Lovelace

- type: picture-glance
  title: Домофон
  entities:
    - entity: script.domru
      icon: 'mdi:door-open'
      name: Открыть дверь
      tap_action:
        action: toggle
  hold_action:
    action: call-service
    service: rest_command.domru_open_door
  camera_image: camera.domru_domofon
- type: entities
  entities:
    - sensor.domru_finances