Синхронизация данных «Здоровья» с Home Assistant

Автоматизации Home Assistant синхронизируют данные о здоровье как состояния сенсоров. Их можно использовать в сценариях Home Assistant, на панелях и в других интеграциях.

Обзор

Метрики отправляются в REST API Home Assistant и создают или обновляют состояния сенсоров. Формат рассчитан на API /states/<entity_id>.

Примеры использования:

• метрики на панелях Home Assistant;
• сценарии по данным о здоровье;
• связка с умным домом;
• тренды во времени.

Возможности:

• автоматическое создание состояний сенсоров;
• только JSON (оптимизировано под Home Assistant);
• только тип «Показатели здоровья»;
• простая настройка URL.

Ограничения

• Доступ к данным о здоровье: при заблокированном iPhone данные недоступны. Автоматизации работают при разблокированном устройстве. См. ручную синхронизацию.

• Фоновая работа: ограничения iOS; фоновое обновление может задерживать запуски.

  • фоновое обновление отключено;
  • режим энергосбережения;
  • долгий простой устройства;
  • нехватка ресурсов;
  • конкуренция приложений.

• только «Показатели здоровья»;

• только JSON (нельзя сменить).

Требования

• работающий и доступный по сети Home Assistant;
• токен API (Long-Lived Access Token);
• сеть до инстанса;
• версия Home Assistant с REST API.

Настройка

Автоматические экспорты → «Новая автоматизация» → тип «Home Assistant».

Имя автоматизации

Имя используется для идентификатора сущности в Home Assistant.

Примечание: имя приводится к нижнему регистру, пробелы убираются. Например, «My Health Data» → hae.myhealthdata.

Уведомления

• При обновлении кэша
• При каждом запуске

URL Home Assistant

Базовый URL инстанса, с протоколом и портом при необходимости.

Примеры:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Примечание: адрес должен быть доступен с устройства. Для HTTPS нужен действующий сертификат или исключение.

Конечная точка

Полный путь API формируется автоматически:

{your_url}/api/states/hae.{automation_name}

Например, URL http://homeassistant.local:8123 и имя «Health Metrics»:

http://homeassistant.local:8123/api/states/hae.healthmetrics

Строка показывается под полем URL для справки.

Тай‑аут запроса

• 60 с — по умолчанию;
• 300 с (5 мин.) — для медленных инстансов;
• 1800 с (30 мин.) — очень медленная обработка;
• 3600 с (1 ч) — максимум, который имеет смысл.

HTTP‑заголовки

Нужен заголовок авторизации с Long-Lived Access Token.

Обязательно:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Как получить токен:

1. Home Assistant
2. Профиль (имя внизу слева)
3. «Long-Lived Access Tokens»
4. «Create Token»
5. Имя, например «Health Auto Export»
6. Скопируйте токен в значение заголовка

Дополнительные заголовки — по необходимости.

Добавление: «Добавить заголовки» — ключ и значение.

Важно: у каждого ключа должно быть значение.

Тип данных

Тип данных

Только «Показатели здоровья»; изменить нельзя.

Показатели

Выбор показателей — все или выборочно.

Совет: меньше метрик — быстрее и меньше объём.

Предпочитаемые источники — приоритет источников.

Параметры экспорта

Формат

Только JSON; изменить нельзя.

Версия экспорта

Недоступна: формат заточен под state API Home Assistant.

Диапазон дат

• По умолчанию — полный вчерашний день плюс данные до сейчас
• Сегодня — текущие сутки до текущего времени
• Вчера — полные предыдущие сутки

Примечание: нет «В реальном времени», «С последней синхронизации», «Предыдущие 7 дней».

Сводка данных

Для показателей здоровья:

• Вкл. — сводки (по умолчанию)
• Выкл. — по возможности отдельные точки

Только для показателей здоровья.

Группировка по времени

При включённой сводке:

• По умолчанию — без агрегации, сырые точки
• Дни — по дням (рекомендуется)

Периодичность

Число и интервал синхронизации с Home Assistant.

Проверка

Ручной тест

1. «Ручной экспорт»
2. Диапазон дат
3. «Экспорт»
4. Проверьте сенсор в Home Assistant

В Home Assistant

1. Откройте Home Assistant
2. Инструменты разработчика → States
3. Поиск hae.{your_automation_name} (нижний регистр, без пробелов)
4. Состояние и данные
5. «Last Updated» для свежести

Журнал активности

1. «Просмотр журнала активности»
2. Запуски и ошибки
3. Время и коды ответов

Журналы Home Assistant

Если данных нет:

1. Настройки → Система → Журналы
2. Ошибки REST API или сенсоров
3. Авторизация и формат данных

Устранение неполадок

Частые проблемы

Ошибки авторизации

• проверьте токен;
• формат Bearer YOUR_TOKEN;
• токен не отозван;
• права в Home Assistant

Сенсор не появился

• без спецсимволов в имени;
• формат hae.{automation_name};
• журналы HA и журнал активности приложения

Данные не обновляются

• автоматизация включена;
• журнал активности;
• сеть до Home Assistant

Тай‑аут

• HA запущен и доступен;
• сеть;
• увеличьте тай‑аут;
• URL и порт

Сообщения об ошибках

Неверный URL, сбой авторизации, коды ошибок HA, сеть.

Смотрите журнал активности: HTTP и текст ответа.

Советы по интеграции

Сценарии

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Панели

1. Панель
2. Новая карточка
3. «Entities» или «Gauge»
4. Сущности hae.{your_automation_name}

Структура состояния

• state — значение или статус;
• attributes — метки времени, JSON как в экспорте, единицы где нужно.

Советы

1. Автосинхронизация: зарядка и трансляция iPhone — как в других автоматизациях.

2. Имена: без проблемных спецсимволов.

3. Данные: только нужные метрики.