Сповіщення про пульс — формат експорту JSON

Документація щодо структури сповіщень про пульс у JSON-експортах

Last updated: April 5, 2026

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

Сповіщення про пульс

Сповіщення про пульс (Heart Rate Notifications) містять попередження про високий і низький пульс з Apple Watch, сповіщення про нерегулярний ритм і детальні дані про пульс, зібрані під час цих подій. У JSON-експортах сповіщення про пульс зберігаються в масиві heartRateNotifications.

Структура

Дані сповіщень про пульс мають унікальну структуру, яка відрізняється від інших показників здоров’я. Кожне сповіщення містить час події, пороги (для сповіщень про високий/низький пульс) і детальні вимірювання пульсу під час події:

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

Поля

Обов’язкові поля

start (Date): час початку події сповіщення про пульс у форматі yyyy-MM-dd HH:mm:ss Z
end (Date): час завершення події сповіщення про пульс у форматі yyyy-MM-dd HH:mm:ss Z
heartRate (Array): масив вимірювань пульсу під час події (див. розділ «Дані про пульс» нижче)
heartRateVariation (Array): масив вимірювань варіабельності серцевого ритму (HRV) під час події (див. розділ «Дані про варіабельність серцевого ритму (HRV)» нижче)

Необов’язкові поля

threshold (Number): поріг пульсу, який спричинив сповіщення. Додається лише для сповіщень про високий і низький пульс.

Типи сповіщень

Сповіщення про високий пульс

Спрацьовує, коли пульс перевищує встановлений поріг (зазвичай 100–150 уд/хв) у спокої.

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

Сповіщення про низький пульс

Спрацьовує, коли пульс падає нижче встановленого порогу (зазвичай 40–50 уд/хв) у спокої.

{
  "start": "2024-02-06 03:00:00 -0800",
  "end": "2024-02-06 03:05:00 -0800",
  "threshold": 40,
  "heartRate": [
    {
      "hr": 38,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 03:00:00 -0800",
        "end": "2024-02-06 03:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

Сповіщення про нерегулярний ритм

Спрацьовує, коли Apple Watch виявляє нерегулярний серцевий ритм, який може вказувати на фібриляцію передсердь.

{
  "start": "2024-02-06 16:00:00 -0800",
  "end": "2024-02-06 16:05:00 -0800",
  "heartRate": [
    {
      "hr": 85,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 35,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

Примітка: сповіщення про нерегулярний ритм не містять поля threshold.

Дані про пульс

Масив heartRate містить детальні вимірювання пульсу під час події сповіщення:

{
  "hr": 105,
  "units": "bpm",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

Поля:

hr (Number): значення пульсу в ударах за хвилину
units (String): одиниця вимірювання (завжди "bpm" — удари за хвилину)
timestamp (Object): період часу для цього вимірювання
- start (Date): початок періоду вимірювання
- end (Date): кінець періоду вимірювання
- interval (Object): тривалість вимірювання
  - duration (Number): числове значення тривалості
  - units (String): одиниця (завжди "s" — секунди)

Дані про варіабельність серцевого ритму (HRV)

Масив heartRateVariation містить вимірювання варіабельності серцевого ритму:

{
  "hrv": 45,
  "units": "ms",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

Поля:

hrv (Number): значення варіабельності серцевого ритму в мілісекундах
units (String): одиниця вимірювання (завжди "ms" — мілісекунди)
timestamp (Object): та сама структура, що й у часової мітки для пульсу

Розуміння HRV:

HRV відображає варіацію часу між ударами серця
вищий HRV зазвичай свідчить про кращу серцево-судинну форму та відновлення після стресу
нижчий HRV може вказувати на стрес, втому або проблеми зі здоров’ям
HRV може суттєво змінюватися залежно від часу доби, рівня активності та індивідуальних факторів

Приклад: повний запис сповіщення

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    },
    {
      "hr": 108,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:05 -0800",
        "end": "2024-02-06 14:30:10 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

Пороги сповіщень

Пороги користувач може налаштувати в параметрах Apple Health:

Високий пульс: зазвичай 100–150 уд/хв (типове значення за замовчуванням залежить від віку)
Низький пульс: зазвичай 40–50 уд/хв (типове значення за замовчуванням залежить від віку)

Поле threshold показує точний поріг, який спричинив сповіщення.

Вимоги до пристрою

Для сповіщень про пульс потрібно:

Apple Watch Series 1 або новіших (для базового моніторингу пульсу)
Apple Watch Series 4 або новіших (для сповіщень про нерегулярний ритм)
watchOS 5.1.2 або новіших (для сповіщень про нерегулярний ритм)
Увімкнені сповіщення в налаштуваннях Apple Health

Сценарії використання

Дані сповіщень про пульс можуть бути корисні для:

Моніторингу здоров’я: відстеження виходу пульсу за межі нормальних діапазонів
Виявлення AFib: моніторинг сповіщень про нерегулярний ритм на можливу фібриляцію передсердь
Медичної документації: передавання подій сповіщень лікарям
Аналізу закономірностей: виявлення тригерів або патернів у подіях пульсу
Інсайтів для фітнесу: розуміння відновлення та реакції на стрес за даними HRV
Кореляції з симптомами: зіставлення сповіщень із симптомами, активністю або ліками

Важливі зауваження

Не медичний пристрій: сповіщення Apple Watch не призначені для заміни професійної медичної діагностики
Консультація з лікарями: завжди обговорюйте сповіщення про пульс із фахівцями, особливо сповіщення про нерегулярний ритм
Контекст має значення: пульс може бути підвищений через фізичні вправи, стрес, кофеїн, ліки або інші фактори
Сповіщення щодо AFib: сповіщення про нерегулярний ритм можуть вказувати на фібриляцію передсердь і їх слід обговорити з лікарем

Поради

Перегляд сповіщень: регулярно переглядайте сповіщення про пульс, щоб помічати закономірності
Контекст події: звертайте увагу, що ви робили під час сповіщень (навантаження, стрес, сон тощо)
Відстеження тенденцій: стежте за частотою та патернами сповіщень з часом
Поєднання з ЕКГ: зіставляйте сповіщення про нерегулярний ритм із знімками ЕКГ для комплексного моніторингу здоров’я серця

Пов’язана документація

Огляд формату експорту JSON
ЕКГ — для детальних знімків ЕКГ
Показники здоров’я — для загальних даних про пульс
Посібник з ручного експорту
Огляд автоматизацій