Автоматизация Deep Link

Создайте автоматизацию REST API, открыв URL на iPhone или iPad.

Последнее обновление: 31 октября 2026 г.

На этой странице

Формат URL

Справка по параметрам

Справка по параметрам Основные настройки Метрики здоровья Тренировки Ритм и уведомления

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

Примеры

Примеры Выбранные метрики, сводка по часам Тренировки с маршрутами

Устранение неполадок Связанная документация

Создайте автоматизацию REST API, открыв URL на iPhone или iPad. Deep links не настраивают другие назначения.

Формат 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`	Boolean; только JSON	`false`

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

О смыслах диапазона дат см. Диапазон дат. Все deep links создают автоматизации REST API; параметра exportDestination нет.

Метрики здоровья

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

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

Тренировки

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

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

Ритм и уведомления

Параметр	Значения или смысл	По умолчанию
`syncinterval`	`minutes`, `hours`, `days`, `weeks`	`minutes`
`syncquantity`	Положительное целое число интервалов	`5`
`notifyonupdate`	Boolean; уведомлять после подготовки данных	`true`
`notifywhenrun`	Boolean; уведомлять после успешного действия назначения	`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; группировка по секундам требует Version 2.
Ошибка пакетной обработки: Задайте format=json или отключите batchrequests.
Недопустимый ритм/таймаут: Используйте поддерживаемые интервалы, положительное количество и таймаут от 60 до 86400 секунд.
URL слишком длинный: Уменьшите список метрик/заголовков или настройте остальные параметры в приложении.

После создания используйте REST API — Экспорт исторических или пропущенных данных, чтобы загрузить выбранный диапазон или проверить настройку.