Métricas de salud - Formato de exportación JSON
Documentación de la estructura de métricas de salud en exportaciones JSON
Última actualización: 31 de octubre de 2026
En esta página
Formatos especiales de métricas
Formatos especiales de métricas Presión arterialFrecuencia cardiacaVariabilidad de la frecuencia cardiacaAnálisis del sueñoGlucosa en sangreNutriciónActividad sexualLavado de manosCepillado de dientesAdministración de insulinaLas exportaciones JSON almacenan las métricas de salud en el array metrics.
Formato del nombre de la métrica
Todos los nombres de métricas en las exportaciones JSON usan el formato snake_case (minúsculas con guiones bajos). Por ejemplo:
- "Step Count" se convierte en
"step_count" - "Blood Pressure" se convierte en
"blood_pressure" - "Heart Rate" se convierte en
"heart_rate" - "Walking + Running Distance" se convierte en
"walking_running_distance"
Estructura
El array metrics contiene objetos, cada uno representando un tipo específico de métrica de salud. La mayoría de las métricas de salud siguen una estructura común:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Campos comunes
name(String): El nombre de la métrica de salud en formato snake_case (p. ej., "step_count", "heart_rate", "active_energy")units(String): La unidad de medida (p. ej., "count", "count/min", "kcal")data(Array): Un array de puntos de datos, cada uno con:qty(Number): El valor de cantidaddate(Date): Marca de tiempo en formatoyyyy-MM-dd HH:mm:ss Zsource(String, cuando esté disponible): La app o el dispositivo que registró la muestra
Formatos especiales de métricas
Algunas métricas de salud tienen estructuras únicas que difieren del formato común:
Presión arterial
Las lecturas de presión arterial incluyen valores sistólicos y diastólicos:
{
"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"
}
]
}
Campos:
systolic(Number): La lectura de presión arterial sistólica (superior). Las exportaciones resumidas usan el promedio de las lecturas del grupo temporal.diastolic(Number): La lectura de presión arterial diastólica (inferior). Las exportaciones resumidas usan el promedio de las lecturas del grupo temporal.
Frecuencia cardiaca
Los datos de frecuencia cardiaca incluyen valores mínimo, medio y máximo:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Campos:
Min(Number): Frecuencia cardiaca mínima durante el periodo de mediciónAvg(Number): Frecuencia cardiaca media durante el periodo de mediciónMax(Number): Frecuencia cardiaca máxima durante el periodo de medición
Variabilidad de la frecuencia cardiaca
Con Resumir datos desactivado, las exportaciones JSON de Variabilidad de la frecuencia cardiaca (SDNN) pueden incluir lecturas latido a latido disponibles. Requieren acceso de lectura a Serie de latidos en Apple Health.
Las exportaciones resumidas, las exportaciones CSV y el HRV de recuperación no incluyen lecturas latido a latido.
Análisis del sueño
La estructura de los datos de sueño depende de si Resumir datos está activado o desactivado.
Resumir datos activado
Con Resumir datos activado, los datos de sueño se resumen por día. Las duraciones de la misma fase se suman. El sueño total es la suma de asleep, core, deep y REM. JSON conserva cada día. En CSV, un grupo temporal más grueso muestra el último día de ese grupo:
{
"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"
}
]
}
Campos:
totalSleep(Number): Tiempo total dormido en horasasleep(Number): Tiempo dormido sin una fase de sueño registrada, en horascore(Number): Duración del sueño core en horasdeep(Number): Duración del sueño profundo en horasrem(Number): Duración del sueño REM en horasawake(Number): Tiempo despierto en horassleepStart(Date): Cuándo empezó realmente el sueñosleepEnd(Date): Cuándo terminó realmente el sueñoinBed(Number): Tiempo total en la cama en horasinBedStart(Date): Cuándo te metiste en la camainBedEnd(Date): Cuándo te levantaste de la cama
Resumir datos desactivado
Con Resumir datos desactivado, se incluyen segmentos de sueño individuales:
{
"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"
}
]
}
Campos:
date,start,startDate(Date): Hora de inicio del segmento de sueñoend,endDate(Date): Hora de fin del segmento de sueñosource(String): La app o el dispositivo que registró el segmentoqty(Number): Duración del segmento en horasvalue(String): Estado del sueño - uno de:"Awake""Asleep"(fase de sueño sin categorizar)"In Bed""Core""REM""Deep""Unspecified"
Nota: "Asleep" se refiere a una fase de sueño sin categorizar (no al tiempo total dormido). Puede ocurrir si el origen de datos no admite el seguimiento de fases del sueño.
Glucosa en sangre
Las lecturas de glucosa en sangre incluyen información sobre el momento de la comida:
{
"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"
}
]
}
Campos:
qty(Number): Nivel de glucosa en sangremealTime(String): Uno de:"Before Meal""After Meal""Unspecified"
Nutrición
Cuando Resumir datos está desactivado, las muestras individuales de cantidad de nutrición (por ejemplo, Energía dietética o Carbohidratos) pueden incluir detalles de alimentos registrados en Apple Health. Por ejemplo:
{
"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"
}
]
}
Campos:
qty(Number): Cantidad del nutriente de la muestrafoodType(String, opcional): Nombre del alimento registrado por la app de origen, cuando esté disponible
Con Resumir datos activado, los totales de nutrición no incluyen foodType.
Actividad sexual
Las entradas de actividad sexual registran el uso de protección:
{
"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"
}
]
}
Campos:
Unspecified(Number): Recuento de eventos ese día cuando el estado de protección es desconocidoProtection Used(Number): Recuento de eventos ese día cuando se usó protecciónProtection Not Used(Number): Recuento de eventos ese día cuando no se usó protección
Las exportaciones resumidas cuentan cada día del calendario. JSON conserva cada día. En CSV, un grupo temporal más grueso muestra el último día de ese grupo.
Lavado de manos
Los eventos de lavado de manos registran el estado de finalización:
{
"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"
}
]
}
Campos:
qty(Number): Duración en segundos. Las exportaciones resumidas usan la duración media del grupo temporal.value(String):"Completed"cuando la sesión dura más de 20 segundos; en caso contrario"Incomplete"
Cepillado de dientes
Los eventos de cepillado de dientes registran el estado de finalización:
{
"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"
}
]
}
Campos:
qty(Number): Duración en segundos. Las exportaciones resumidas usan la duración media del grupo temporal.value(String):"Completed"cuando la sesión dura al menos 2 minutos; en caso contrario"Incomplete"
Administración de insulina
Las entradas de administración de insulina incluyen el motivo de la administración:
{
"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"
}
]
}
Campos:
qty(Number): Cantidad de insulina administrada. Las exportaciones resumidas suman las cantidades del grupo temporal.reason(String): Uno de:"Bolus"(insulina en las comidas)"Basal"(insulina de fondo)