HealthyApps Help Center

Notificações de Frequência Cardíaca - Formato de Exportação JSON

Documentação sobre a estrutura de notificações de frequência cardíaca em exportações JSON

Last updated: February 6, 2026

On this page

Notificações de Frequência Cardíaca

As notificações de frequência cardíaca incluem alertas de frequência cardíaca alta e baixa do Apple Watch, notificações de ritmo irregular e dados detalhados de frequência cardíaca recolhidos durante estes eventos. Nas exportações JSON, as notificações de frequência cardíaca são armazenadas no array heartRateNotifications.

Estrutura

Os dados de notificação de frequência cardíaca têm uma estrutura única que difere de outras métricas de saúde. Cada notificação inclui o momento do evento, limites (para notificações altas/baixas) e medições detalhadas de frequência cardíaca durante o evento:

{
  "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"
        }
      }
    }
  ]
}

Campos

Campos Obrigatórios

  • start (Data): Hora de início do evento de notificação de frequência cardíaca no formato yyyy-MM-dd HH:mm:ss Z
  • end (Data): Hora de fim do evento de notificação de frequência cardíaca no formato yyyy-MM-dd HH:mm:ss Z
  • heartRate (Array): Array de medições de frequência cardíaca durante o evento (veja Dados de Frequência Cardíaca abaixo)
  • heartRateVariation (Array): Array de medições de variabilidade da frequência cardíaca (HRV) durante o evento (veja Dados de HRV abaixo)

Campos Opcionais

  • threshold (Número): Limite de frequência cardíaca que acionou a notificação. Incluído apenas para notificações de frequência cardíaca alta e baixa.

Tipos de Notificação

Notificação de Frequência Cardíaca Alta

Acionada quando a frequência cardíaca excede um limite definido (tipicamente 100-150 bpm) enquanto em repouso.

{
  "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": []
}

Notificação de Frequência Cardíaca Baixa

Acionada quando a frequência cardíaca desce abaixo de um limite definido (tipicamente 40-50 bpm) enquanto em repouso.

{
  "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": []
}

Notificação de Ritmo Irregular

Acionada quando o Apple Watch deteta um ritmo cardíaco irregular que pode indicar fibrilação auricular.

{
  "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"
        }
      }
    }
  ]
}

Nota: As notificações de ritmo irregular não incluem um campo threshold.

Dados de Frequência Cardíaca

O array heartRate contém medições detalhadas de frequência cardíaca durante o evento de notificação:

{
  "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"
    }
  }
}

Campos:

  • hr (Número): Valor da frequência cardíaca em batimentos por minuto
  • units (String): Unidade de medida (sempre "bpm" para batimentos por minuto)
  • timestamp (Objeto): Período de tempo para esta medição
    • start (Data): Início do período de medição
    • end (Data): Fim do período de medição
    • interval (Objeto): Duração da medição
      • duration (Número): Valor da duração
      • units (String): Unidade (sempre "s" para segundos)

Dados de Variabilidade da Frequência Cardíaca (HRV)

O array heartRateVariation contém medições de variabilidade da frequência cardíaca:

{
  "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"
    }
  }
}

Campos:

  • hrv (Número): Valor da variabilidade da frequência cardíaca em milissegundos
  • units (String): Unidade de medida (sempre "ms" para milissegundos)
  • timestamp (Objeto): Mesma estrutura do timestamp de frequência cardíaca

Compreender a HRV:

  • A HRV mede a variação no tempo entre os batimentos cardíacos
  • Uma HRV mais alta geralmente indica melhor condicionamento cardiovascular e recuperação do stresse
  • Uma HRV mais baixa pode indicar stresse, fadiga ou problemas de saúde
  • A HRV pode variar significativamente com base na hora do dia, nível de atividade e fatores individuais

Exemplo: Entrada Completa de Notificação

{
  "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"
        }
      }
    }
  ]
}

Limites de Notificação

Os limites são configuráveis pelo utilizador nas definições do Apple Health:

  • Frequência Cardíaca Alta: Tipicamente 100-150 bpm (o padrão varia por idade)
  • Frequência Cardíaca Baixa: Tipicamente 40-50 bpm (o padrão varia por idade)

O campo threshold mostra o limite exato que acionou a notificação.

Requisitos do Dispositivo

As notificações de frequência cardíaca exigem:

  • Apple Watch Series 1 ou posterior (para monitorização básica de frequência cardíaca)
  • Apple Watch Series 4 ou posterior (para notificações de ritmo irregular)
  • WatchOS 5.1.2 ou posterior (para notificações de ritmo irregular)
  • Notificações ativadas nas definições do Apple Health

Casos de Utilização

Os dados de notificação de frequência cardíaca podem ser úteis para:

  • Monitorização de saúde: Rastrear quando a frequência cardíaca excede intervalos normais
  • Deteção de FA: Monitorizar notificações de ritmo irregular para possível fibrilação auricular
  • Registos médicos: Partilhar eventos de notificação com prestadores de cuidados de saúde
  • Análise de padrões: Identificar gatilhos ou padrões em eventos de frequência cardíaca
  • Insights de fitness: Compreender recuperação e respostas ao stresse através de dados de HRV
  • Correlação de sintomas: Cruzar referências de notificações com sintomas, atividades ou medicamentos

Notas Importantes

  • Não é um dispositivo médico: As notificações do Apple Watch não se destinam a substituir o diagnóstico médico profissional
  • Consulte prestadores de cuidados de saúde: Consulte sempre profissionais de saúde sobre notificações de frequência cardíaca, especialmente alertas de ritmo irregular
  • O contexto importa: A frequência cardíaca pode estar elevada devido a exercícios, stresse, cafeína, medicamentos ou outros fatores
  • Notificações de FA: As notificações de ritmo irregular podem indicar fibrilação auricular e devem ser discutidas com um prestador de cuidados de saúde

Dicas

  • Rever notificações: Reveja regularmente as notificações de frequência cardíaca para identificar padrões
  • Anotar contexto: Considere o que estava a fazer quando as notificações ocorreram (exercício, stresse, sono, etc.)
  • Rastrear tendências: Monitore a frequência e os padrões de notificação ao longo do tempo
  • Combinar com ECG: Cruzar referências de notificações de ritmo irregular com leituras de ECG para monitorização abrangente da saúde cardíaca

Documentação Relacionada