Синхронизация данных 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.

Настройки типа данных

Выберите один Тип данных для этой автоматизации: Показатели здоровья, Тренировки, Симптомы, ЭКГ, Уведомления о пульсе, Состояние разума, Отслеживание цикла менструации или Лекарства. Состояние разума требует 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 или уменьшите размер экспорта.

Откройте автоматизацию и выберите Смотреть журналы активности, чтобы просмотреть запуск. Предупреждение отмечает потенциальные проблемы, такие как медленное получение данных; Ошибки: указывают на неудачные шаги. За помощью в сообщении о проблеме см. Получение помощи.