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

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

Last updated: February 5, 2026

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

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

Огляд

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

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

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

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

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

Обмеження

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

передумови

Дійсна кінцева точка 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

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

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

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

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

Тип даних

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

Показники здоров’я – кроки, пульс, сон та інші показники здоров’я
Тренування – фізичні вправи та фітнес-заходи
Симптоми – симптоми та стан здоров’я
ЕКГ - показники електрокардіограми
Сповіщення про частоту серцевих скорочень - події високого/низького пульсу
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 увімкніть пакетні запити, щоб надсилати дані пакетами через кілька запитів замість одного корисного навантаження.

УВІМКНЕНО – розподіляє дані між кількома запитами, щоб уникнути надмірно великого корисного навантаження
ВИМКНЕНО - надсилає всі дані одним запитом

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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