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

Интеграция данных о здоровье с Home Assistant.

Last updated: May 20, 2026

На этой странице

Руководство по автоматизации Home Assistant

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

Обзор

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

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

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

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

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

Ограничения

Доступ к данным о здоровье: Приложениям запрещён доступ к данным о здоровье, пока iPhone заблокирован. Автоматизации выполняются только в периоды, когда устройство разблокировано. Это ограничение Apple, его нельзя обойти. Подробнее
Фоновая работа: ограничения 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

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

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

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

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

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

Тип данных

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

Показатели

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

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

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

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

Формат

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

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

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

Диапазон дат

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

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

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

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

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

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

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

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

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

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

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

Проверка

В Home Assistant

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

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

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

Журналы Home Assistant

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

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

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

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

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

проверьте токен;
формат 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!"

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

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

Советы

Автоматическая синхронизация:
- Заряжайте устройство и используйте Зеркалирование iPhone
  - При зарядке iOS накладывает меньше ограничений на производительность, поэтому данные могут синхронизироваться чаще
  - При зеркалировании iPhone устройство ведёт себя как разблокированное. Health Auto Export может получать доступ к данным о здоровье для автоматических действий
Автосинхронизация: зарядка и трансляция iPhone — как в других автоматизациях.
Имена: без проблемных спецсимволов.
Данные: только нужные метрики.

Просмотр журналов активности

Нажмите Просмотр журналов активности на экране настройки автоматизации.
Просмотрите запуски (сгруппированы, сначала новые) и разверните события в каждом запуске.
Различайте предупреждения (например, медленный запрос данных о здоровье) и ошибки (сбои публикации сущности или подключения)—см. Обзор автоматизаций — Журналы активности.
Запуски Home Assistant могут фиксировать результаты по сущностям; запуск может быть частично успешным, когда одни сущности обновляются, а другие — нет.
Поделиться (панель инструментов) экспортирует полный диагностический ZIP Журналы событий приложения для поддержки (как Настройки → Дополнительно).
Очистить удаляет только журнал активности этой автоматизации.