Ohjekeskus HealthyApps
Suomi
Ohjekeskus
Pääsivusto ↗

Hae ohjeaiheita

Sykeilmoitukset - JSON-vientimuoto

Dokumentaatio sykeilmoitusten rakenteesta JSON-vienneissä

Päivitetty viimeksi: 31. lokakuuta 2026

Tällä sivulla
Rakenne
Kentät Kentät Pakolliset kentätValinnaiset kentät
SyketiedotAiheeseen liittyvä dokumentaatio

Sykeilmoitukset sisältävät Apple Watchin korkean ja matalan sykkeen hälytykset, epäsäännöllisen rytmin ilmoitukset sekä näiden tapahtumien aikana kerätyt sykenäytteet. JSON-vienneissä sykeilmoitukset tallennetaan taulukkoon heartRateNotifications.

Rakenne

Kukin ilmoitus sisältää tapahtuman ajoituksen, valinnaisen kynnysarvon (korkeille/matalille ilmoituksille), lähdetiedot ja sykenäytteet määräsarjana tapahtuman alun ja lopun välillä:

{
  "heartNotification": "high_heart_rate_notification",
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "source": {
    "name": "Apple Watch",
    "identifier": "com.example.recorder"
  },
  "heartRateData": [
    {
      "qty": 105,
      "units": "count/min",
      "start": 1707258600,
      "end": 1707258605
    }
  ]
}

Kentät

Pakolliset kentät

  • heartNotification (String): Ilmoitustyypin tunniste
  • start (Date): Sykeilmoitustapahtuman alkuaika muodossa yyyy-MM-dd HH:mm:ss Z
  • end (Date): Sykeilmoitustapahtuman päättymisaika muodossa yyyy-MM-dd HH:mm:ss Z
  • source (Object): Ilmoituksen tallentanut laite/lähde
    • name (String): Lähteen luettava nimi
    • identifier (String): Lähteen pakettitunniste
  • heartRateData (Array): Sykemääränäytteet tapahtumaikkunan aikana (katso Syketiedot alla)

Valinnaiset kentät

  • threshold (Number): Sykekynnys, joka laukaisi ilmoituksen. Sisältyy vain korkean ja matalan sykkeen ilmoituksiin.

Syketiedot

Kenttä heartRateData sisältää sykemittaukset määräsarjana ilmoitustapahtuman ikkunan aikana. Kukin näyte sisältää kentät qty, units, start ja end:

{
  "qty": 105,
  "units": "count/min",
  "start": 1707258600,
  "end": 1707258605
}

Kentät:

  • qty (Number): Sykearvo
  • units (String): Mittayksikkö (tyypillisesti "count/min")
  • start (Number): Mittausjakson alku Unix-epoch-sekunteina
  • end (Number): Mittausjakson loppu Unix-epoch-sekunteina

Aiheeseen liittyvä dokumentaatio