Hjælpecenter HealthyApps
Dansk
Hjælpecenter
Hovedwebsted ↗

Søg i hjælpeemner

Sundhedsmålinger - JSON-eksportformat

Dokumentation for strukturen for sundhedsmålinger i JSON-eksporter

Senest opdateret: 31. oktober 2026

På denne side
Format for målingsnavne
Struktur Struktur Fælles felter
Særlige målingsformater Særlige målingsformater BlodtrykPulsHjertefrekvensvariabilitetSøvnanalyseBlodsukkerErnæringSeksuel aktivitetHåndvaskTandbørstningInsulinlevering
Relateret dokumentation

JSON-eksporter gemmer sundhedsmålinger i arrayet metrics.

Format for målingsnavne

Alle målingsnavne i JSON-eksporter bruger formatet snake_case (små bogstaver med underscores). For eksempel:

  • "Step Count" bliver "step_count"
  • "Blood Pressure" bliver "blood_pressure"
  • "Heart Rate" bliver "heart_rate"
  • "Walking + Running Distance" bliver "walking_running_distance"

Struktur

Arrayet metrics indeholder objekter, der hver repræsenterer en specifik type sundhedsmåling. De fleste sundhedsmålinger følger en fælles struktur:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

Fælles felter

  • name (String): Navnet på sundhedsmålingen i snake_case-format (f.eks. "step_count", "heart_rate", "active_energy")
  • units (String): Måleenheden (f.eks. "count", "count/min", "kcal")
  • data (Array): Et array af datapunkter, der hver indeholder:
    • qty (Number): Mængdeværdien
    • date (Date): Tidsstempel i formatet yyyy-MM-dd HH:mm:ss Z
    • source (String, når tilgængelig): Appen eller enheden, der registrerede prøven

Særlige målingsformater

Nogle sundhedsmålinger har unikke strukturer, der adskiller sig fra det fælles format:

Blodtryk

Blodtryksmålinger inkluderer både systoliske og diastoliske værdier:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

Felter:

  • systolic (Number): Den systoliske (øvre) blodtryksmåling. Opsummerede eksporter bruger gennemsnittet af målingerne i tidsgruppen.
  • diastolic (Number): Den diastoliske (nedre) blodtryksmåling. Opsummerede eksporter bruger gennemsnittet af målingerne i tidsgruppen.

Puls

Pulsdata inkluderer minimum-, gennemsnits- og maksimumværdier:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

Felter:

  • Min (Number): Minimumspuls i måleperioden
  • Avg (Number): Gennemsnitspuls i måleperioden
  • Max (Number): Maximumspuls i måleperioden

Hjertefrekvensvariabilitet

Med Opsummer data slået fra kan JSON-eksporter af hjertefrekvensvariabilitet (SDNN) inkludere tilgængelige beat-to-beat-målinger. Disse kræver læseadgang til Hjerteslags-serie i Apple Health.

Opsummerede eksporter, CSV-eksporter og Recovery HRV inkluderer ikke beat-to-beat-målinger.

Søvnanalyse

Strukturen for søvndata afhænger af, om Opsummer data er slået til eller fra.

Opsummer data til

Med Opsummer data til opsummeres søvndata pr. dag. Varigheder i samme fase lægges sammen. Total søvn er asleep, core, deep og REM lagt sammen. JSON beholder hver dag. I CSV viser en grovere tidsgruppe den seneste dag i den gruppe:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

Felter:

  • totalSleep (Number): Samlet tid i søvn i timer
  • asleep (Number): Tid i søvn uden registreret søvnfase, i timer
  • core (Number): Core-søvnvarighed i timer
  • deep (Number): Dyb søvnvarighed i timer
  • rem (Number): REM-søvnvarighed i timer
  • awake (Number): Tid vågen i timer
  • sleepStart (Date): Hvornår søvnen faktisk startede
  • sleepEnd (Date): Hvornår søvnen faktisk sluttede
  • inBed (Number): Samlet tid i seng i timer
  • inBedStart (Date): Hvornår du gik i seng
  • inBedEnd (Date): Hvornår du stod op

Opsummer data fra

Med Opsummer data fra inkluderes individuelle søvnsegmenter:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

Felter:

  • date, start, startDate (Date): Starttidspunkt for søvnsegmentet
  • end, endDate (Date): Sluttidspunkt for søvnsegmentet
  • source (String): Appen eller enheden, der registrerede segmentet
  • qty (Number): Segmentets varighed i timer
  • value (String): Søvntilstand - en af:
    • "Awake"
    • "Asleep" (ukategoriseret søvnfase)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Bemærk: "Asleep" refererer til en ukategoriseret søvnfase (ikke samlet tid i søvn). Dette kan forekomme, hvis datakilden ikke understøtter sporing af søvnfaser.

Blodsukker

Blodsukkermålinger inkluderer oplysninger om måltidstiming:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

Felter:

  • qty (Number): Blodsukkerniveau
  • mealTime (String): En af:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Ernæring

Når Opsummer data er slået fra, kan individuelle ernæringsmængdeprøver (for eksempel Kostenergi eller Kulhydrater) inkludere madoplysninger registreret i Apple Health. For eksempel:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

Felter:

  • qty (Number): Næringsmængde for prøven
  • foodType (String, valgfri): Madnavn registreret af kildeappen, når det er tilgængeligt

Med Opsummer data til inkluderer ernæringstotaler ikke foodType.

Seksuel aktivitet

Poster for seksuel aktivitet sporer brug af beskyttelse:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

Felter:

  • Unspecified (Number): Antal begivenheder den dag, hvor beskyttelsesstatus er ukendt
  • Protection Used (Number): Antal begivenheder den dag, hvor beskyttelse blev brugt
  • Protection Not Used (Number): Antal begivenheder den dag, hvor beskyttelse ikke blev brugt

Opsummerede eksporter tæller hver kalenderdag. JSON beholder hver dag. I CSV viser en grovere tidsgruppe den seneste dag i den gruppe.

Håndvask

Håndvasksbegivenheder sporer fuldførelsesstatus:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

Felter:

  • qty (Number): Varighed i sekunder. Opsummerede eksporter bruger den gennemsnitlige varighed i tidsgruppen.
  • value (String): "Completed", når sessionen varer mere end 20 sekunder; ellers "Incomplete"

Tandbørstning

Tandbørstningsbegivenheder sporer fuldførelsesstatus:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

Felter:

  • qty (Number): Varighed i sekunder. Opsummerede eksporter bruger den gennemsnitlige varighed i tidsgruppen.
  • value (String): "Completed", når sessionen varer mindst 2 minutter; ellers "Incomplete"

Insulinlevering

Poster for insulinlevering inkluderer årsagen til levering:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

Felter:

  • qty (Number): Mængde leveret insulin. Opsummerede eksporter summerer mængderne i tidsgruppen.
  • reason (String): En af:
    • "Bolus" (måltidsinsulin)
    • "Basal" (basisinsulin)

Relateret dokumentation