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
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 formatyyyy-MM-dd HH:mm:ss Zsource(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 mesureAvg(Number) : Fréquence cardiaque moyenne pendant la période de mesureMax(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 heuresasleep(Number) : Temps endormi sans phase de sommeil enregistrée, en heurescore(Number) : Durée du sommeil core en heuresdeep(Number) : Durée du sommeil profond en heuresrem(Number) : Durée du sommeil REM en heuresawake(Number) : Temps éveillé en heuressleepStart(Date) : Moment où le sommeil a réellement commencésleepEnd(Date) : Moment où le sommeil a réellement pris fininBed(Number) : Temps total au lit en heuresinBedStart(Date) : Moment où vous vous êtes mis au litinBedEnd(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 sommeilend,endDate(Date) : Heure de fin du segment de sommeilsource(String) : L’app ou l’appareil qui a enregistré le segmentqty(Number) : Durée du segment en heuresvalue(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émiemealTime(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’échantillonfoodType(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 inconnuProtection Used(Number) : Nombre d’événements ce jour-là lorsque la protection a été utiliséeProtection 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)