Синхронізація даних про здоров’я Apple із Home Assistant

Інтегруйте свої дані про здоров’я за допомогою Home Assistant.

Last updated: February 5, 2026

На цій сторінці

Автоматизація Home Assistant дозволяє автоматично синхронізувати ваші дані про здоров’я з Home Assistant як стани датчиків. Ця інтеграція дає змогу використовувати ваші дані про здоров’я в системах автоматизації Home Assistant, на інформаційних панелях та інших інтеграціях.

Огляд

Автоматизація Home Assistant надсилає ваші показники здоров’я в Home Assistants REST API, створюючи або оновлюючи стани датчиків, які можна використовувати у вашому екземплярі Home Assistant. Дані відформатовано спеціально для API /states/ Home Assistant.

Випадки використання:

Відображення показників здоров’я на інформаційних панелях Home Assistant
Створіть автоматизацію на основі даних про стан здоров’я
Інтегруйте дані про здоров’я з іншими пристроями розумного дому
Відстежуйте тенденції здоров’я з часом у Home Assistant

Ключові характеристики:

Автоматичне створення стану датчика
Лише формат JSON (оптимізований для Home Assistant)
Лише тип даних показників здоров’я
Проста конфігурація URL

Обмеження

Доступ до даних про здоров’я: Додаткам заборонено отримувати доступ до даних про здоров’я, коли iPhone заблоковано. Автоматизація працюватиме лише в періоди, коли ваш пристрій розблоковано. Це може вплинути на актуальність даних. Перегляньте інструкції щодо синхронізації вручну, щоб підтримувати актуальність даних.
Фонова обробка: iOS обмежує фонову обробку, щоб зберегти заряд акумулятора. Автоматизації покладаються на фонове оновлення додатків і можуть не запуститися негайно, якщо:
- Фонове оновлення програми вимкнено для програми
- Пристрій у режимі низького енергоспоживання
- Пристрій був неактивний протягом тривалого часу
- Системні ресурси обмежені
- Кілька програм конкурують за час виконання у фоновому режимі
Підтримує лише тип даних Health Metrics
Лише формат JSON (неможливо змінити)

передумови

Екземпляр Home Assistant працює та доступний у вашій мережі
Маркер доступу до API Home Assistant (довговічний маркер доступу)
Підключення до мережі до вашого домашнього помічника
Версія Home Assistant, яка підтримує REST API

Конфігурація

Перейдіть на екран автоматизованого експорту з головної панелі навігації, потім торкніть «Нова автоматизація» та виберіть «Домашній помічник» як тип автоматизації.

Назва автоматизації

Введіть описову назву для автоматизації. Це ім’я використовуватиметься для створення ідентифікатора датчика в Home Assistant.

Примітка. Ім’я автоматизації буде перетворено на малі літери з видаленням пробілів для створення ідентифікатора об’єкта. Наприклад, «Мої дані про здоров’я» стає hae.myhealthdata.

Сповіщення

Налаштуйте, коли ви хочете отримувати сповіщення:

Повідомляти про оновлення кешу - отримуйте сповіщення, коли кешовані дані оновлюються
Повідомляти під час запуску - отримуйте сповіщення щоразу, коли виконується автоматизація

URL-адреса домашнього помічника

Введіть базову URL-адресу свого екземпляра Home Assistant. Це має включати протокол і порт, якщо не використовуються стандартні.

Приклади URL-адрес:

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

Примітка. URL-адреса має бути доступною з вашого пристрою. Якщо ви використовуєте HTTPS, переконайтеся, що ваш сертифікат дійсний, або додайте виняток.

Автоматично створена кінцева точка

Програма автоматично генерує повну кінцеву точку API на основі вашої назви автоматизації:

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

Наприклад, якщо ваша URL-адреса – http://homeassistant.local:8123, а назва автоматизації – «Показники здоров’я», кінцева точка буде:

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

Ця кінцева точка відображається під полем URL-адреси для довідки.

Час очікування запиту

Виберіть інтервал очікування для запитів HTTP до Home Assistant.

Доступні параметри тайм-ауту:

60 секунд – за умовчанням, підходить для більшості екземплярів Home Assistant
300 секунд (5 хвилин) – для повільніших екземплярів Home Assistant
1800 секунд (30 хвилин) – для дуже повільної обробки
3600 секунд (1 година) - максимальний рекомендований час очікування

Заголовки HTTP

Додайте заголовки автентифікації для доступу до Home Assistant API. Вам потрібно буде додати заголовок авторизації з довгостроковим маркером доступу.

Обов’язковий заголовок:

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Щоб отримати довготривалий маркер доступу:

Відкрийте Домашній помічник
Перейдіть до свого профілю (натисніть своє ім'я внизу ліворуч)
Прокрутіть униз до розділу «Довгострокові маркери доступу»
Натисніть «Створити маркер»
Дайте назву (наприклад, «Health Auto Export»)
Скопіюйте маркер і вставте його в поле значення заголовка

Додаткові заголовки:
Ви можете додати додаткові заголовки, якщо це необхідно для налаштування Home Assistant.

Щоб додати заголовки:

Натисніть «Додати заголовки»
Введіть ключ заголовка в лівому полі
Введіть значення заголовка в правому полі
Повторіть для додаткових заголовків

Важливо: кожен ключ заголовка повинен мати відповідне значення. Порожні заголовки ігноруватимуться.

Параметри типу даних

Тип даних

Примітка. Автоматизація Home Assistant підтримує лише тип даних Health Metrics. Цей параметр не можна змінити, і для нього автоматично встановлено показники стану здоров’я.

Конфігурація показників здоров'я

Виберіть показники здоров’я – виберіть, які конкретні показники включити. Ви можете вибрати всі доступні показники або вибрати окремі.

Підказка. Вибір лише необхідних показників може покращити час обробки та зменшити розмір даних, які надсилаються до Home Assistant.

Переважні джерела – налаштуйте, які джерела даних мають пріоритет, якщо кілька джерел надають однакову метрику.

Налаштування експорту

Формат експорту

Примітка. Автоматизація Home Assistant підтримує лише формат JSON. Цей параметр не можна змінити, і для нього автоматично встановлено значення JSON.

Експорт версії

Примітка. Експортована версія недоступна для автоматизації Home Assistant, оскільки формат оптимізовано спеціально для API стану Home Assistant.

Діапазон дат

Виберіть, коли потрібно експортувати дані:

За замовчуванням – синхронізує дані за весь попередній день, а також дані до поточної дати й часу
Сьогодні - синхронізує всі дані за поточну дату до поточного часу
Вчора – синхронізує всі дані за весь попередній день

Примітка. Автоматизація Home Assistant не підтримує параметри «Реальний час», «З моменту останньої синхронізації» або «Попередні 7 днів».

Узагальнення даних

Увімкніть або вимкніть підсумкові дані для показників здоров’я.

УВІМКНЕНО – надає зведені підсумкові дані (за замовчуванням)
ВИМКНЕНО – де це можливо, надає дезагреговані дані

Примітка. Цей параметр застосовується лише до типу даних показників здоров’я.

Групування часу

Коли ввімкнено «Підведення підсумків даних», виберіть спосіб агрегування даних:

За замовчуванням – без агрегації, необроблені точки даних
Дні – групування даних за днями (рекомендовано)

Синхронізація каденції

Налаштуйте, як часто автоматизація має синхронізувати дані з Home Assistant:

Виберіть число та інтервал.

Тестування та перевірка

Ручне тестування

Натисніть «Експорт вручну» на екрані налаштування автоматизації
Виберіть діапазон дат
Натисніть «Експортувати», щоб надіслати тестовий запит
Перевірте Home Assistant, щоб переконатися, що стан датчика створено/оновлено

Перевірка в Home Assistant

Відкрийте Домашній помічник
Перейдіть до Інструменти розробника > Штати
Шукати hae.{your_automation_name} (нижні літери, без пробілів)
Переконайтеся, що стан датчика відображає дані про ваше здоров’я
Перевірте мітку часу «Останнє оновлення», щоб підтвердити останні синхронізації

Перегляд журналів активності

Натисніть «Переглянути журнали активності» на екрані налаштування автоматизації
Перегляньте останні запуски автоматизації
Перевірте наявність помилок або попереджень
Перевірте позначки часу запиту та статус відповіді

Перевірка журналів домашнього помічника

Якщо дані не відображаються в Home Assistant:

Відкрийте Домашній помічник
Перейдіть до Налаштування > Система > Журнали
Шукайте помилки, пов’язані з REST API або станами датчиків
Перевірте наявність помилок автентифікації або неправильного формату даних

Усунення несправностей

Загальні питання

Помилки автентифікації

Переконайтеся, що ваш довготривалий маркер доступу правильний
Переконайтеся, що заголовок авторизації має такий формат: Bearer YOUR_TOKEN
Переконайтеся, що термін дії маркера не закінчився або його не відкликано
Переконайтеся, що маркер має відповідні дозволи в Home Assistant

Датчик не відображається в Home Assistant

Переконайтеся, що назва автоматизації не містить спеціальних символів
Перевірте формат ідентифікатора об’єкта: hae.{automation_name} (малі літери, без пробілів)
Перевірте журнали Home Assistant на наявність помилок
Переконайтеся, що запит API був успішним (перевірте журнали активності)

Дані не оновлюються

Перевірте, чи включена автоматизація
Перегляньте журнали активності на наявність помилок
Забезпечте підключення до мережі Home Assistant

Тайм-аут підключення

Переконайтеся, що Домашній помічник запущений і доступний
Перевірте підключення до мережі
Збільште параметр Request Timeout, якщо Home Assistant повільно відповідає
Перевірте правильність URL-адреси та порту

Повідомлення про помилки

Програма відображатиме повідомлення про помилки, якщо:

URL-адреса недійсна або недоступна
Помилка автентифікації (перевірте заголовок авторизації)
Home Assistant повертає код статусу помилки
Підключення до мережі недоступне

Перевірте журнали активності, щоб отримати детальну інформацію про помилки, включаючи коди стану HTTP та повідомлення про помилки від Home Assistant.

Поради щодо інтеграції домашнього помічника

Використання даних про стан здоров’я в автоматизації

Коли ваші дані про стан здоров’я буде синхронізовано з Home Assistant, ви зможете використовувати їх в автоматизації:

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!"

Створення інформаційних панелей

Додайте показники здоров’я на інформаційну панель Home Assistant:

Перейдіть на інформаційну панель
Додайте нову картку
Виберіть тип картки «Об’єкти» або «Калібр».
Додайте сенсорні сутності hae.{your_automation_name}

Структура стану датчика

Стан датчика в Home Assistant містить:

state: поточне значення або статус
attributes: додаткові дані, зокрема:
- Інформація про мітку часу
- Структура даних відповідає експортованому формату JSON
- Інформація про одиницю, де це можливо

Поради та найкращі практики

Автоматична синхронізація:
- Заряджайте свій пристрій і використовуйте iPhone Mirroring
  - Коли ваш пристрій заряджається, iOS накладає менше обмежень на продуктивність пристрою, тому дані можуть синхронізуватися частіше
  - За допомогою iPhone Mirroring ваш пристрій поводиться так само, як якщо б його було розблоковано. Це означає, що дані про здоров’я доступні за допомогою Health Auto Export для виконання автоматизованих дій
Найменування:
- Уникайте спеціальних символів, які можуть викликати проблеми
Вибір даних:
- Виберіть лише ті показники, які вам потрібні