Hjälpcenter HealthyApps
Svenska
Hjälpcenter
Huvudwebbplats ↗

Sök bland hjälpämnen

Hälsomått - JSON-exportformat

Dokumentation för strukturen för hälsomått i JSON-exporter

Senast uppdaterad: 31 oktober 2026

På denna sida
Format för måttnamn
Struktur Struktur Gemensamma fält
Särskilda måttformat Särskilda måttformat BlodtryckHjärtfrekvensHjärtfrekvensvariabilitetSömnanalysBlodsockerNäringSexuell aktivitetHandtvättTandborstningInsulinleverans
Relaterad dokumentation

JSON-exporter lagrar hälsomått i arrayet metrics.

Format för måttnamn

Alla måttnamn i JSON-exporter använder formatet snake_case (gemener med understreck). Till exempel:

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

Struktur

Arrayet metrics innehåller objekt, där varje objekt representerar en specifik typ av hälsomått. De flesta hälsomått följer en gemensam struktur:

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

Gemensamma fält


  • name (String): Namnet på hälsomåttet i snake_case-format (t.ex. "step_count", "heart_rate", "active_energy")
  • units (String): Måttenheten (t.ex. "count", "count/min", "kcal")
  • data (Array): En array med datapunkter, som var och en innehåller:
    • qty (Number): Mängdvärdet
    • date (Date): Tidsstämpel i formatet yyyy-MM-dd HH:mm:ss Z
    • source (String, när tillgängligt): Appen eller enheten som registrerade provet

Särskilda måttformat

Vissa hälsomått har unika strukturer som skiljer sig från det gemensamma formatet:

Blodtryck

Blodtrycksmätningar inkluderar både systoliska och diastoliska värden:

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

Fält:

  • systolic (Number): Den systoliska (övre) blodtrycksmätningen. Summerade exporter använder genomsnittet av mätningarna i tidsgruppen.
  • diastolic (Number): Den diastoliska (nedre) blodtrycksmätningen. Summerade exporter använder genomsnittet av mätningarna i tidsgruppen.

Hjärtfrekvens

Hjärtfrekvensdata inkluderar minimum-, genomsnitts- och maximumvärden:

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

Fält:

  • Min (Number): Minimihjärtfrekvens under mätperioden
  • Avg (Number): Genomsnittlig hjärtfrekvens under mätperioden
  • Max (Number): Maximihjärtfrekvens under mätperioden

Hjärtfrekvensvariabilitet

Med Summer data avstängt kan JSON-exporter av hjärtfrekvensvariabilitet (SDNN) inkludera tillgängliga beat-to-beat-mätningar. Dessa kräver läsbehörighet för Hjärtrytmserie i Apple Health.

Summerade exporter, CSV-exporter och Recovery HRV inkluderar inte beat-to-beat-mätningar.

Sömnanalys

Strukturen för sömndata beror på om Summer data är på eller av.

Summer data på

Med Summer data på summeras sömndata per dag. Varaktigheter i samma fas läggs ihop. Total sömn är asleep, core, deep och REM lagda ihop. JSON behåller varje dag. I CSV visar en grovare tidsgrupp den senaste dagen i den gruppen:

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

Fält:

  • totalSleep (Number): Total tid i sömn i timmar
  • asleep (Number): Tid i sömn utan registrerad sömnfas, i timmar
  • core (Number): Core-sömnens längd i timmar
  • deep (Number): Djupsömnens längd i timmar
  • rem (Number): REM-sömnens längd i timmar
  • awake (Number): Tid vaken i timmar
  • sleepStart (Date): När sömnen faktiskt började
  • sleepEnd (Date): När sömnen faktiskt slutade
  • inBed (Number): Total tid i sängen i timmar
  • inBedStart (Date): När du gick till sängs
  • inBedEnd (Date): När du steg upp

Summer data av


Med Summer data av inkluderas individuella sömnsegment:

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

Fält:

  • date, start, startDate (Date): Starttid för sömnsegmentet
  • end, endDate (Date): Sluttid för sömnsegmentet
  • source (String): Appen eller enheten som registrerade segmentet
  • qty (Number): Segmentets längd i timmar
  • value (String): Sömntillstånd - ett av:
    • "Awake"
    • "Asleep" (okategoriserad sömnfas)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Obs: "Asleep" avser en okategoriserad sömnfas (inte total tid i sömn). Detta kan förekomma om datakällan inte stöder spårning av sömnfaser.

Blodsocker

Blodsockermätningar inkluderar information 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"
    }
  ]
}

Fält:

  • qty (Number): Blodsockernivå
  • mealTime (String): Ett av:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Näring

När Summer data är avstängt kan individuella näringsmängdprover (till exempel Dietary Energy eller Carbohydrates) inkludera matdetaljer som registrerats i Apple Health. Till exempel:

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

Fält:

  • qty (Number): Näringsmängd för provet
  • foodType (String, valfritt): Matnamn registrerat av källappen, när det finns

Med Summer data på inkluderar näringstotaler inte foodType.

Sexuell aktivitet

Poster för sexuell aktivitet spårar användning av skydd:

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

Fält:

  • Unspecified (Number): Antal händelser den dagen när skyddsstatus är okänd
  • Protection Used (Number): Antal händelser den dagen när skydd användes
  • Protection Not Used (Number): Antal händelser den dagen när skydd inte användes

Summerade exporter räknar varje kalenderdag. JSON behåller varje dag. I CSV visar en grovare tidsgrupp den senaste dagen i den gruppen.

Handtvätt

Handtvättshändelser spårar slutförandestatus:

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

Fält:

  • qty (Number): Längd i sekunder. Summerade exporter använder genomsnittlig längd i tidsgruppen.
  • value (String): "Completed" när sessionen varar mer än 20 sekunder, annars "Incomplete"

Tandborstning

Tandborstningshändelser spårar slutförandestatus:

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

Fält:

  • qty (Number): Längd i sekunder. Summerade exporter använder genomsnittlig längd i tidsgruppen.
  • value (String): "Completed" när sessionen varar minst 2 minuter, annars "Incomplete"

Insulinleverans

Poster för insulinleverans inkluderar orsaken till leveransen:

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

Fält:

  • qty (Number): Mängd levererat insulin. Summerade exporter summerar mängderna i tidsgruppen.
  • reason (String): Ett av:
    • "Bolus" (måltidsinsulin)
    • "Basal" (basinsulin)

Relaterad dokumentation