Автоматизація глибокого посилання

Створіть автоматизацію REST API, відкривши URL на iPhone або iPad

Останнє оновлення: 31 жовтня 2026 р.

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

Формат URL

Довідник параметрів

Довідник параметрів Базові параметри Показники здоров’я Тренування Частота та сповіщення

Автентифікація та кодування

Приклади

Приклади Вибрані показники, узагальнені щогодини Тренування з маршрутами

Усунення несправностей Пов’язана документація

Створіть автоматизацію REST API, відкривши URL на iPhone або iPad. Глибокі посилання не налаштовують інші призначення.

Формат URL

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export

url обов’язковий. Надайте описову name; якщо пропущено, за замовчуванням Automation. Назви параметрів не чутливі до регістру. URL-кодуйте значення параметрів, що містять пробіли або зарезервовані символи.

Відкрийте URL на пристрої або використайте Відкрити URL у Командах. Перегляньте створену автоматизацію в Health Auto Export перед увімкненням.

Довідник параметрів

Булеві значення приймають true/false, 1/0 або yes/no. Встановіть datatype перед його параметрами для даних і format перед aggregatedata, щоб пізніші вибори не замінювали попередні налаштування.

Базові параметри

Параметр	Значення або значення	За замовчуванням
`url`	URL кінцевої точки, доступний з пристрою	Обов’язково
`name`	Ненепорожня назва автоматизації	`Automation`
`enabled`	Увімкнути автоматичні запуски	`false`
`datatype`	Тип даних нижче	`healthMetrics`
`format`	`json`, `csv`, `markdown` або `md`	`json`
`exportversion`	`v1`, `v2`, `1` або `2`	`v2`
`period`	`none`, `lastsync`, `today`, `yesterday`, `previous7days`	`none`
`requesttimeout`	Цілі секунди, 60–86400	`60`
`headers`	Пари ключ/значення через кому	Немає
`batchrequests`	Булеве; лише JSON	`false`

Дійсні типи даних: healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking і medications. Стан розуму потребує iOS 18 або новішої; експорти ліків потребують iOS 26 або новішої.

Значення діапазонів дат див. у Діапазон дат. Усі глибокі посилання створюють автоматизації REST API; параметра exportDestination немає.

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

Параметр	Значення або значення	За замовчуванням
`metrics`	Точні назви показників через кому, наприклад `Step Count,Heart Rate`	Усі доступні показники
`aggregatedata`	Булеве; використовуйте `false` для окремих значень, де підтримується	`true`
`interval`	`none`, `minutes`, `hours`, `days`, `weeks`, `months`, `years`	`none`
`aggregatesleep`	Булеве, що керує узагальненням сну	`true`

metrics, aggregatedata і interval застосовуються до показників здоров’я. Вибір CSV вмикає узагальнення; використовуйте JSON для окремих значень. Явно вказуйте бажане узагальнення під час генерації посилань.

Тренування

Параметр	Значення або значення	За замовчуванням коли `datatype=workouts`
`includeroutes`	Булеве	`true`
`includeworkoutmetadata`	Булеве	`true`
`workoutsmetadatainterval`	`minutes` або `seconds`; Версія 2	`minutes`
`workouttypes`	Ідентифікатори типу тренування Apple без знака через кому	Усі типи

Не включайте параметри агрегації показників здоров’я в посилання тренування.

Частота та сповіщення

Параметр	Значення або значення	За замовчуванням
`syncinterval`	`minutes`, `hours`, `days`, `weeks`	`minutes`
`syncquantity`	Додатне ціле число інтервалів	`5`
`notifyonupdate`	Булеве; сповіщати після підготовки даних	`true`
`notifywhenrun`	Булеве; сповіщати після успішної дії призначення	`true`

Частота залишається підлеглою лімітам фону та даних про здоров’я; це не точний розклад.

Автентифікація та кодування

Значення headers складається з ключів і значень, що чергуються:

headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY

Кожен ключ потребує значення. Коми розділяють пари, тому уникайте значень заголовків із комами в цьому форматі посилання. Кодуйте пробіли як %20, плюси як %2B і амперсанди як %26. Кодуйте повний URL кінцевої точки, коли він має власні параметри запиту.

Приклади

Вибрані показники, узагальнені щогодини

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours

Тренування з маршрутами

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes

Обидва приклади залишають автоматичні запуски вимкненими, доки ви не переглянете та не увімкнете автоматизацію.

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

Помилка URL або параметра: Почніть із мінімального URL, перевірте написання та кодування, потім додавайте параметри по одному.
Недійсний показник: Використовуйте точну назву показника, включно з пробілами та регістром.
Помилка агрегації: Використовуйте параметри показників здоров’я лише з datatype=healthMetrics.
Помилка параметрів тренування: Використовуйте параметри тренування з datatype=workouts; групування в секундах потребує Версії 2.
Помилка пакетування: Встановіть format=json або вимкніть batchrequests.
Недійсна частота/тайм-аут: Використовуйте підтримувані інтервали, додатну кількість і тайм-аут від 60 до 86400 секунд.
URL занадто довгий: Скоротіть список показників/заголовків або налаштуйте решту в застосунку.

Після створення використайте REST API — Експорт історичних або пропущених даних, щоб завантажити вибраний діапазон або перевірити налаштування.