HealthyApps Help Center

Синхронізація Apple Health Data з REST API

Надсилайте дані про стан до кінцевої точки REST API.

Last updated: June 9, 2026

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

Посібник з автоматизації REST API

Автоматизація REST API дозволяє автоматично експортувати ваші дані про здоров’я в будь-який веб-сервіс, який приймає запити HTTP POST. Це ідеально підходить для інтеграції з власними серверними програмами, сторонніми API або веб-хуками.

Огляд

Автоматизація REST API надсилає ваші дані про стан здоров’я на вказану кінцеву точку URL-адреси за допомогою запитів HTTP POST. Автоматизація може надсилати дані у форматі JSON або CSV із настроюваними заголовками для автентифікації та спеціальними метаданими.

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

  • Інтеграція з настроюваними серверними службами
  • Надсилання даних на веб-хуки
  • Синхронізація зі сторонніми API
  • Створення спеціальних інформаційних панелей або аналітичних платформ

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

  • Підтримує формати JSON і CSV
  • Спеціальні заголовки HTTP для автентифікації
  • Настроюваний час очікування запиту
  • Експорт історичних даних вручну

Обмеження:

  • Доступ до даних про здоров’я: Застосункам заборонено отримувати доступ до даних про здоров’я, поки iPhone заблоковано. Автоматизації виконуються лише в періоди, коли пристрій розблоковано. Це обмеження Apple, його не можна обійти. Докладніше

  • Фонова обробка: iOS обмежує фонову обробку для економії заряду акумулятора. Автоматизації залежать від фонового оновлення застосунків і можуть не запускатися одразу, якщо:

    • для застосунку вимкнено фонове оновлення застосунків
    • пристрій у режимі енергозбереження
    • пристрій довго неактивний
    • системні ресурси обмежені
    • кілька застосунків конкурують за час фонового виконання

Продуктивність

Пам’ятайте, що iOS оптимізований для короткочасних завдань на мобільному пристрої з дуже суворими обмеженнями продуктивності. Фонові завдання зазвичай мають завершитися протягом 30 секунд і обмежені в обсязі пам’яті. Health Auto Export пропонує великий ступінь гнучкості та налаштування, тому важливо розуміти, як певні конфігурації впливають на продуктивність застосунку та результати.

  • Конфігурація: Автоматизації, які створюють великі обсяги даних, можуть призвести до завершення процесу системою, і автоматизації не працюватимуть у фоні. Наступні конфігурації можуть створювати великі обсяги даних:
    • Автоматизації, налаштовані на експорт усіх показників здоров’я.
      • Рекомендація: вибирайте лише показники здоров’я, для яких у Apple Health є збережені дані, і лише ті дані, які ви дійсно плануєте використовувати. Навіть порожні типи даних впливають на продуктивність. Можна також розділити вибрані показники між кількома автоматизаціями — це полегшує обробку для системи.
    • Автоматизації з групуванням за часом у секундах або хвилинах або з вимкненим підсумовуванням даних. Такі детальні запити можуть тривати довго й суперечити системним обмеженням.
      • Рекомендація: хоча здається ідеальним мати максимально детальні дані, подумайте, чи потрібен такий рівень деталізації для кожного показника чи типу даних. Розгляньте кілька автоматизацій з різними налаштуваннями.
    • Під час експорту тренувань на відкритому повітрі, таких як велосипед, біг, піші походи тощо з даними маршруту, GPS і пов’язані показники здоров’я можуть створювати великі обсяги даних.
  • Розмір даних: Особливо при експорті через REST API враховуйте, що великі обсяги даних можуть спричиняти помилки сервера. Переконайтеся, що ваш бекенд налаштований на обробку обсягів даних, можливо, кількох сотень мегабайт.
  • Частота синхронізації: Додайте віджет автоматизацій на головний екран, щоб автоматизації надійніше працювали у фоні (див. Посібник з налаштування віджета автоматизацій).

передумови

  • Дійсна кінцева точка URL-адреси, яка приймає запити HTTP POST
  • Облікові дані автентифікації (якщо цього вимагає ваша кінцева точка)
  • Підключення до мережі для досягнення кінцевої точки

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

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

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

Введіть описову назву для вашої автоматизації (наприклад, «My Backend API», «Webhook Integration»).

Сповіщення

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

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

Конфігурація URL-адреси

Введіть повну URL-адресу, куди ви хочете надіслати дані про своє здоров’я. Це має бути повна URL-адреса, включаючи протокол (http:// або https://).

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

  • https://api.example.com/health-data
  • https://webhook.site/your-unique-id
  • http://localhost:3000/api/health

Примітка. URL-адреса має бути дійсною та доступною з вашого пристрою. Недійсні URL-адреси перешкоджатимуть запуску автоматизації.

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

Виберіть інтервал очікування для запитів HTTP. Це визначає, як довго програма чекатиме відповіді, перш ніж вважати запит невдалим.

Заголовки HTTP

Додайте спеціальні заголовки HTTP для автентифікації або метаданих. Загальні випадки використання включають:

  • Ключі API: X-API-Key: your-api-key
  • Маркери авторизації: Authorization: Bearer your-token
  • Перевизначення типу вмісту: Content-Type: application/json

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

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

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

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

Тип даних

Виберіть тип даних про стан здоров’я для експорту:

  • Показники здоров’я – кроки, пульс, сон та інші показники здоров’я
  • Тренування – фізичні вправи та фітнес-заходи
  • Симптоми – симптоми та стан здоров’я
  • ЕКГ - показники електрокардіограми
  • Сповіщення про частоту серцевих скорочень - події високого/низького пульсу
  • State of Mind - записи про настрій і психічний стан (iOS 18.0+)
  • Відстеження циклу – дані про менструальний цикл і репродуктивне здоров’я
  • Ліки - Журнали прийому ліків і дотримання (iOS 26.0+)

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

Коли вибрано показники здоров’я:

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

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

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

Конфігурація тренування

Коли вибрано тренування:

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

Включити показники тренувань – увімкніть, щоб включити показники здоров’я, зібрані під час тренувань (частота серцевих скорочень, калорії тощо).

Групування часу (показники тренування) - якщо використовується експорт версії 2 і включено показники тренування:

  • Хвилини – Групує показники тренувань за хвилинами
  • Секунди - Групує показники тренування за секундами

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

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

Виберіть формат експортованих даних:

  • Формат JSON – надає докладні структури даних із вкладеними об’єктами. Найкраще підходить для API, баз даних і програм, яким потрібні структуровані дані. Формат JSON містить більш детальну інформацію для складних типів даних, таких як фази сну та показання AFib.

  • Формат CSV – надає табличні дані, які можна легко імпортувати в програми для роботи з електронними таблицями. Найкраще для простого аналізу даних або коли ваша кінцева точка очікує даних CSV.

Примітка. Заголовок Content-Type автоматично встановлюється на application/json для експорту JSON і multipart/form-data для експорту CSV.

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

Виберіть версію для експорту. Контроль версій дозволяє переходити між оновленими версіями експорту у вашому власному темпі та мінімізує негативні зміни в робочих процесах.

  • Версія 1 – застарілий формат, використовуйте, якщо у вас є робочі процеси, які залежать від цього формату
  • Версія 2 – поточний формат із покращеними даними про тренування та більш детальними параметрами метаданих

Діапазон дат

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

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

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

У разі використання формату JSON із типом даних Health Metrics увімкніть або вимкніть підсумкові дані.

  • ON – надає зведені дані
  • ВИМКНЕНО – де це можливо, надає дезагреговані дані, показуючи окремі точки даних

Примітка. Цей параметр застосовується лише до формату JSON із показниками стану здоров’я. Дані завжди агрегуються, якщо використовується формат CSV або коли вибрано кілька показників.

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

У разі використання формату JSON із увімкненим узагальненням даних виберіть спосіб агрегування даних.

Примітка. Формат CSV завжди збирає дані. Агрегація хвилин і другого рівня може значно збільшити час обробки та розмір даних.

Пакетні запити та великі корисні навантаження

У форматі JSON увімкніть Пакетні запити, щоб надсилати дані кількома HTTP-запитами замість одного великого навантаження.

  • УВІМК. — Розподіляє дані між кількома запитами. Використовуйте, якщо кінцева точка має обмеження розміру, таймаути великих тіл або поетапну обробку.
  • ВИМК. — Надсилає всі дані одним запитом. Підходить для менших експортів і простих вебхуків.

Коли вмикати пакетну відправку:

  • Багато метрик здоров’я, довгі діапазони дат або дрібне групування за часом (хвилини/секунди)
  • Підсумок даних вимкнено й ви експортуєте розділені метрики
  • Сервер повертає помилки або таймаути для великих тіл POST

Примітки:

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

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

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

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

Перевірка формату даних

Програма автоматично включає ці заголовки в кожен запит:

  • Content-Type – набір на основі формату експорту
  • automation-name - назва вашої автоматизації
  • automation-id - Унікальний ідентифікатор для автоматизації
  • automation-aggregation – вибране групування часу
  • automation-period – вибраний діапазон дат
  • session-id - унікальний ідентифікатор для кожного запиту

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

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

Дані не отримано в кінцевій точці

  • Переконайтеся, що URL-адреса кінцевої точки правильна
  • Перевірте, чи ваша кінцева точка приймає запити POST
  • Перегляньте заголовки автентифікації
  • Перевірте журнали кінцевих точок на наявність вхідних запитів
  • Перевірте підключення до мережі

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

  1. Автоматична синхронізація:

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

  2. Продуктивність:

    • Використовуйте відповідне групування за часом, щоб збалансувати деталі та розмір даних
    • Виберіть лише ті показники, які вам потрібні

  3. Надійність:

    • Установіть відповідні значення часу очікування на основі часу відповіді кінцевої точки
    • Регулярно відстежуйте журнали активності

  4. Формат даних:

    • Використовуйте JSON для структурованих даних і API
    • Використовуйте CSV для простого аналізу даних або інтеграції електронних таблиць
    • Розгляньте пакетні запити для великих наборів даних або окрему обробку

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

  1. Натисніть Переглянути журнали активності на екрані налаштування автоматизації.
  2. Перегляньте запуски (згруповано, спочатку новіші) і розгорніть події в кожному запуску.
  3. Розрізняйте попередження (наприклад, повільний запит даних про здоров’я) та помилки (помилки HTTP, таймаути або збої читання HealthKit)—див. Огляд автоматизацій — Журнали активності.
  4. Успішні REST-завантаження часто показують зведення з форматом, типом даних, періодом експорту та діапазоном дат у запуску.
  5. Поділитися (панель інструментів) експортує повний діагностичний ZIP Журнали подій застосунку для підтримки (як Налаштування → Додатково).
  6. Очистити видаляє лише журнал активності цієї автоматизації.