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

Надсилайте експорти здоров’я на кінцеву точку, яка приймає HTTP POST-запити.

Важливо — обмеження автоматизацій: Пристрій має бути розблоковано для читання даних про здоров’я, і iOS не гарантує фонові запуски з вибраною частотою. Перегляньте Обмеження автоматизацій перед покладанням на автоматичні експорти.

Відкриття автоматизації

Відкрийте Експорт → Автоматизовано на iPhone або Автоматизації на бічній панелі iPad. Виберіть Нова автоматизація або відкрийте наявну автоматизацію для редагування.

Назва, стан і сповіщення

Введіть назву, яка ідентифікує цю автоматизацію. Увімкнено дозволяє автоматичні запуски; залиште вимкненим, доки не будете готові.

Виберіть потрібні сповіщення про запуск:

• Сповіщати про оновлення кешу повідомляє, що дані експорту підготовлено.
• Сповіщати про запуск повідомляє про успішне завантаження на вашу кінцеву точку.

Дозвольте сповіщення, коли запропоновано. Ці сповіщення повідомляють про активність; вони не планують запуск.

Налаштування кінцевої точки

1. Виберіть REST API як Тип автоматизації.
2. Введіть URL-адресу, доступну з iPhone або iPad, наприклад https://api.example.com/health-data.
3. Додайте будь-яку потрібну автентифікацію в HTTP-заголовках. Наприклад, використовуйте Authorization як ключ і Bearer YOUR_TOKEN як значення.
4. Виберіть Тайм-аут запиту, відповідний для вашої кінцевої точки.

Кожен заголовок потребує і ключа, і значення. Для сервера на іншому пристрої використовуйте його доступну мережеву адресу, а не localhost.

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

Виберіть один Тип даних для цієї автоматизації: Показники здоров’я, Тренування, Симптоми, ECG, Сповіщення про частоту серцевих скорочень, Стан розуму, Відстеження циклу або Ліки. Стан розуму потребує iOS 18 або новішої; Ліки потребують iOS 26 або новішої та окремого доступу до ліків.

Показники здоров’я

Виберіть Показники здоров’я, потім відкрийте Вибрати показники здоров’я і виберіть потрібні вимірювання.

Щоб обмежити значення певними застосунками або пристроями, відкрийте Бажані джерела, виберіть показник і його джерела. Усі дозволяє кожне джерело, яке не виключено. Використовуйте Виключені джерела, щоб ігнорувати джерело в показниках здоров’я цієї автоматизації. Виключення мають пріоритет; невибране джерело не підставляється, коли бажане джерело не має даних. Виберіть Зберегти, щоб застосувати вибір джерел, або Скасувати, щоб відхилити.

Тренування

Виберіть Тренування, щоб експортувати записи тренувань. Включити дані маршруту додає доступні точки маршруту до JSON-даних тренування. Окремі GPX-завантаження не створюються.

Для Версії 2 увімкніть Включити показники тренування, щоб додати значення, наприклад частоту серцевих скорочень, активну енергію та кроки. Виберіть Хвилини або Секунди для Групування часу показників тренування; секунди дають більше деталей і більші експорти. Версія 1 завжди включає показники тренування.

Параметри експорту

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

• JSON зберігає структуровані дані для інтеграцій і аналізу.
• CSV створює табличні файли для електронних таблиць.
• Markdown створює читабельні заголовки та таблиці для нотаток і архівів.

Версія експорту

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

Діапазон дат

Вибір	Включені дані
За замовчуванням	Попередній день і сьогодні до часу запуску
З останньої синхронізації	З попередньої синхронізації до часу запуску
Сьогодні	Сьогодні до часу запуску
Вчора	Попередній повний день
Попередні 7 днів	Попередні сім повних днів

Узагальнити дані та групування часу

Для JSON + Показники здоров’я увімкніть Узагальнити дані, щоб об’єднати значення в групи часу, або вимкніть для окремих значень, де доступно. Узагальнення залежить від показника — наприклад, кроки підсумовуються, а значення ваги усереднюються. CSV-експорти показників здоров’я використовують узагальнені дані.

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

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

Для REST API + JSON увімкніть Пакетні запити, щоб надсилати дані кількома запитами. Використовуйте це, коли кінцева точка відхиляє великі тіла або великі запити перевищують тайм-аут. Служба приймання має обробляти кожен запит окремо.

Пакетування недоступне для CSV і Markdown. Воно зменшує розмір окремих запитів, але не зменшує обсяг даних про здоров’я, які пристрій має прочитати. Див. Продуктивність, якщо підготовка повільна.

Планування нагадувань

Якщо потрібне нагадування розблокувати та відкрити застосунок, увімкніть Увімкнути нагадування. Виберіть Щогодини, Щодня або Вибрані дні, потім встановіть хвилину, час і дні за потреби. Дозвольте доступ до сповіщень, коли запропоновано; якщо відхилено, використайте Відкрити параметри сповіщень.

Нагадування не запускає автоматизацію і не підтверджує успішну синхронізацію. Торкніться, щоб відкрити автоматизацію, або використайте Відкрити та синхронізувати на сповіщенні, щоб запросити запуск. Автоматизація має бути увімкнена; нагадування може все ще з’явитися після успішного фонового запуску. Зміни нагадувань набувають чинності під час збереження.

Частота синхронізації та збереження

Виберіть число та Хвилини, Години, Дні або Тижні в Частоті синхронізації — наприклад, кожні 15 хвилин. Це бажана фонова частота, а не гарантований розклад.

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

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

Заголовки запиту

Застосунок встановлює Content-Type для вибраного формату та включає:

Заголовок	Значення
automation-name	Назва автоматизації
automation-id	Ідентифікатор автоматизації
automation-aggregation	Вибране групування часу
automation-period	Вибраний діапазон дат
session-id	Ідентифікатор запиту

Експорт історичних або пропущених даних

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

1. Відкрийте автоматизацію та виберіть Завантаження вручну в Експортувати наявні дані.
2. Встановіть дати Початок і Кінець, потім виберіть Почати експорт.
3. Перевірте отриманий запит, заголовки та тіло на кінцевій точці.

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

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

Відкрийте автоматизацію та виберіть Переглянути журнали активності, щоб переглянути запуск. Попередження позначають потенційні проблеми, наприклад повільне отримання даних; помилки визначають невдалі кроки. Для допомоги зі звітом про проблему див. Отримання допомоги.