Centre d'aide HealthyApps
Français
Centre d'aide
Site principal ↗

Rechercher dans l’aide

Indicateurs de santé - Format d’exportation JSON

Documentation de la structure des indicateurs de santé dans les exportations JSON

Dernière mise à jour: 31 octobre 2026

Sur cette page
Format du nom d’indicateur
Structure Structure Champs communs
Formats d’indicateurs spéciaux Formats d’indicateurs spéciaux Tension artérielleFréquence cardiaqueVariabilité de la fréquence cardiaqueAnalyse du sommeilGlycémieNutritionActivité sexuelleLavage des mainsBrossage des dentsAdministration d’insuline
Documentation associée

Les exportations JSON stockent les indicateurs de santé dans le tableau metrics.

Format du nom d’indicateur

Tous les noms d’indicateurs dans les exportations JSON utilisent le format snake_case (minuscules avec tirets bas). Par exemple :

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

Structure

Le tableau metrics contient des objets, chacun représentant un type d’indicateur de santé spécifique. La plupart des indicateurs de santé suivent une structure commune :

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

Champs communs

  • name (String) : Le nom de l’indicateur de santé au format snake_case (p. ex. "step_count", "heart_rate", "active_energy")
  • units (String) : L’unité de mesure (p. ex. "count", "count/min", "kcal")
  • data (Array) : Un tableau de points de données, chacun contenant :
    • qty (Number) : La valeur de quantité
    • date (Date) : Horodatage au format yyyy-MM-dd HH:mm:ss Z
    • source (String, lorsqu’il est disponible) : L’app ou l’appareil qui a enregistré l’échantillon

Formats d’indicateurs spéciaux

Certains indicateurs de santé ont des structures uniques qui diffèrent du format commun :

Tension artérielle

Les lectures de tension artérielle incluent les valeurs systolique et diastolique :

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

Champs :

  • systolic (Number) : La lecture de tension artérielle systolique (supérieure). Les exportations résumées utilisent la moyenne des lectures du groupe temporel.
  • diastolic (Number) : La lecture de tension artérielle diastolique (inférieure). Les exportations résumées utilisent la moyenne des lectures du groupe temporel.

Fréquence cardiaque

Les données de fréquence cardiaque incluent les valeurs minimale, moyenne et maximale :

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

Champs :

  • Min (Number) : Fréquence cardiaque minimale pendant la période de mesure
  • Avg (Number) : Fréquence cardiaque moyenne pendant la période de mesure
  • Max (Number) : Fréquence cardiaque maximale pendant la période de mesure

Variabilité de la fréquence cardiaque

Avec Résumer les données désactivé, les exportations JSON de la Variabilité de la fréquence cardiaque (SDNN) peuvent inclure les lectures battement à battement disponibles. Elles nécessitent un accès en lecture à Série de battements dans Apple Santé.

Les exportations résumées, les exportations CSV et le HRV de récupération n’incluent pas les lectures battement à battement.

Analyse du sommeil

La structure des données de sommeil dépend de l’activation ou non de Résumer les données.

Résumer les données activé

Avec Résumer les données activé, les données de sommeil sont résumées par jour. Les durées de la même phase sont additionnées. Le sommeil total est la somme de asleep, core, deep et REM. JSON conserve chaque jour. En CSV, un groupe temporel plus grossier affiche le dernier jour de ce groupe :

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

Champs :

  • totalSleep (Number) : Temps total de sommeil en heures
  • asleep (Number) : Temps endormi sans phase de sommeil enregistrée, en heures
  • core (Number) : Durée du sommeil core en heures
  • deep (Number) : Durée du sommeil profond en heures
  • rem (Number) : Durée du sommeil REM en heures
  • awake (Number) : Temps éveillé en heures
  • sleepStart (Date) : Moment où le sommeil a réellement commencé
  • sleepEnd (Date) : Moment où le sommeil a réellement pris fin
  • inBed (Number) : Temps total au lit en heures
  • inBedStart (Date) : Moment où vous vous êtes mis au lit
  • inBedEnd (Date) : Moment où vous vous êtes levé

Résumer les données désactivé

Avec Résumer les données désactivé, les segments de sommeil individuels sont inclus :

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

Champs :

  • date, start, startDate (Date) : Heure de début du segment de sommeil
  • end, endDate (Date) : Heure de fin du segment de sommeil
  • source (String) : L’app ou l’appareil qui a enregistré le segment
  • qty (Number) : Durée du segment en heures
  • value (String) : État du sommeil - l’un de :
    • "Awake"
    • "Asleep" (phase de sommeil non catégorisée)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Note : "Asleep" désigne une phase de sommeil non catégorisée (et non le temps total endormi). Cela peut se produire si la source de données ne prend pas en charge le suivi des phases de sommeil.

Glycémie

Les lectures de glycémie incluent des informations sur le moment du repas :

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

Champs :

  • qty (Number) : Niveau de glycémie
  • mealTime (String) : L’un de :
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Nutrition

Lorsque Résumer les données est désactivé, les échantillons individuels de quantité nutritionnelle (par exemple Énergie alimentaire ou Glucides) peuvent inclure des détails alimentaires enregistrés dans Apple Santé. Par exemple :

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

Champs :

  • qty (Number) : Quantité du nutriment pour l’échantillon
  • foodType (String, facultatif) : Nom de l’aliment enregistré par l’app source, lorsqu’il est disponible

Avec Résumer les données activé, les totaux nutritionnels n’incluent pas foodType.

Activité sexuelle

Les entrées d’activité sexuelle enregistrent l’utilisation de protection :

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

Champs :

  • Unspecified (Number) : Nombre d’événements ce jour-là lorsque le statut de protection est inconnu
  • Protection Used (Number) : Nombre d’événements ce jour-là lorsque la protection a été utilisée
  • Protection Not Used (Number) : Nombre d’événements ce jour-là lorsque la protection n’a pas été utilisée

Les exportations résumées comptent chaque jour calendaire. JSON conserve chaque jour. En CSV, un groupe temporel plus grossier affiche le dernier jour de ce groupe.

Lavage des mains

Les événements de lavage des mains enregistrent l’état d’achèvement :

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

Champs :

  • qty (Number) : Durée en secondes. Les exportations résumées utilisent la durée moyenne du groupe temporel.
  • value (String) : "Completed" lorsque la session dure plus de 20 secondes, sinon "Incomplete"

Brossage des dents

Les événements de brossage des dents enregistrent l’état d’achèvement :

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

Champs :

  • qty (Number) : Durée en secondes. Les exportations résumées utilisent la durée moyenne du groupe temporel.
  • value (String) : "Completed" lorsque la session dure au moins 2 minutes, sinon "Incomplete"

Administration d’insuline

Les entrées d’administration d’insuline incluent le motif de l’administration :

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

Champs :

  • qty (Number) : Quantité d’insuline administrée. Les exportations résumées additionnent les quantités du groupe temporel.
  • reason (String) : L’un de :
    • "Bolus" (insuline au moment des repas)
    • "Basal" (insuline de fond)

Documentation associée