¿Qué tipos de datos de Apple Health envía Life Dashboard?

La app para iPhone lee 28 tipos de Apple Health (la app Salud del iPhone), y cada uno está desactivado hasta que lo activas en Qué enviar, por categoría o con Lo esencial o Todos los tipos. Los envía con las claves del payload de la app para Android, con los mismos campos y unidades: pasos, distancia y calorías, entrenamientos, peso y composición corporal, frecuencia cardíaca, frecuencia cardíaca en reposo y HRV, presión arterial, glucosa, saturación de oxígeno, frecuencia respiratoria, VO2 máx., sueño con sus fases, hidratación, nutrición, mindfulness, temperatura corporal y seguimiento del ciclo. La menstruación sale como dos claves, así que un iPhone envía 29 de las 34 claves de la app para Android.

Cada registro lleva un uuid, el de la propia muestra de Apple Health, y un source: el nombre que Apple Health da a la app o al dispositivo que lo escribió. La app solo lee; nunca escribe en Apple Health.

Por Owen Vogelaar, que mantiene Life Dashboard 10 min de lectura

Consigue la app para iPhone

Todos los tipos de un vistazo

La columna Apple Watch indica dónde la documentación de Apple describe que el reloj registra ese tipo; Apple Watch en Home Assistant enlaza cada página. Los demás tipos vienen del iPhone, de lo que anotas tú o de apps que escriben en Apple Health.

TipoClave del payloadValor y unidadHome AssistantApple Watch
PasosstepscountTotal de hoySí, y el iPhone
DistanciadistancemetersTotal de hoySí, y el iPhone
Energía activaactive_caloriescalories, kcalTotal de hoySí
Energía totaltotal_caloriescalories, kcalTotal de hoySí
Entrenamientosexercisetype, duration_secondsÚltimo entrenamiento, minutos de hoy y de ayerSí
PesoweightkilogramsÚltimo valorNo
AlturaheightmetersÚltimo valorNo
Porcentaje de grasa corporalbody_fatpercentageÚltimo valorNo
Masa corporal magralean_body_masskilogramsÚltimo valorNo
Frecuencia cardíacaheart_ratebpmÚltimo valorSí
Frecuencia cardíaca en reposoresting_heart_ratebpmÚltimo valorSí
Variabilidad de la frecuencia cardíacaheart_rate_variabilityheart_rate_variability_millis, ms (SDNN)Último valorSí
Presión arterialblood_pressuresystolic, diastolic, mmHgDos sensoresNo
Oxígeno en sangreoxygen_saturationpercentageÚltimo valorAlgunos modelos y regiones
Frecuencia respiratoriarespiratory_raterate, respiraciones por minutoÚltimo valorSí, mientras duermes
Temperatura corporalbody_temperaturecelsiusÚltimo valorNo
Temperatura corporal basalbasal_body_temperaturecelsiusÚltimo valorNo
Glucosa en sangreblood_glucosemmol_per_literÚltimo valorNo
VO2 máx.vo2_maxvo2_ml_per_min_per_kgÚltimo valorSí, durante algunos entrenamientos
Sueñosleepduration_seconds, stagesDuración del último sueño, tiempo dormido y horas por faseSí, con fases
Mindfulnessmindfulnessduration_secondsMinutos por día, en las estadísticasDesconocido
AguahydrationlitersÚltima bebidaNo
Nutriciónnutritioncalories, gramos y 34 nutrientes másCalorías, proteínas, carbohidratos y grasas consumidos hoyNo
Menstruaciónmenstruation_flow, menstruation_periodflow; start_time, end_timeSin sensorNo
Manchadointermenstrual_bleedingSolo la horaSin sensorNo
Resultado de prueba de ovulaciónovulation_testresultSin sensorNo
Calidad del moco cervicalcervical_mucusappearance, sensationSin sensorNo
Actividad sexualsexual_activityprotection_usedSin sensorNo

"No" y "Desconocido" en la columna Apple Watch significan que la documentación de Apple sobre el reloj, tal como se cita en este sitio, no describe que el reloj lo registre, no que nada pueda hacerlo. Para ver qué escribe un tipo en tu propio iPhone, abre la app Salud, busca el tipo y mira en Fuentes de datos y acceso.

Qué fuente escribe cada tipo

  • Apple Watch: pasos, distancia, energía activa y en reposo, entrenamientos, frecuencia cardíaca, frecuencia cardíaca en reposo, HRV, sueño con sus fases, frecuencia respiratoria mientras duermes, VO2 máx. durante algunos entrenamientos al aire libre, y oxígeno en sangre en los modelos y las regiones que lo tienen. Apple Watch en Home Assistant tiene los detalles y las páginas de Apple.
  • iPhone: pasos y distancia. Un iPhone sin reloj no suele registrar energía en reposo, así que total_calories llega sobre todo con un reloj.
  • Otras apps y dispositivos: las apps de otros relojes, anillos y básculas, como Garmin Connect, Oura y Withings, pueden escribir en Apple Health, y también las apps en las que anotas comida, agua, seguimiento del ciclo o meditación. Lo que escriben depende de la app y de tu configuración en ella; cada registro nombra la app en source.

Apple Health guarda dos veces un paseo que registraron tanto el iPhone como el reloj, una por dispositivo. Los daily_totals de cada payload lo cuentan una sola vez, en el orden de las fuentes de datos que estableces en la app Salud, así que usa esos para los totales del día.

Actividad

Pasos

Clave steps: count, un número entero, en un intervalo de start_time a end_time. Hasta 1000 registros nuevos por sincronización.

Distancia

Clave distance: meters, en un intervalo. Apple Health guarda un tipo de distancia por clase de actividad, y la app los lee todos: caminar y correr, ciclismo, natación, silla de ruedas, deportes de nieve de descenso y, desde iOS 18, remo, deportes de pala, esquí de fondo y patinaje. No se solapan, así que al sumarlos no se cuenta nada dos veces. Un registro no dice de qué actividad viene.

Energía activa

Clave active_calories: calories en kcal, en un intervalo. Es la energía activa de Apple Health.

Energía total

Clave total_calories: calories en kcal, en un intervalo. Apple Health no tiene un tipo de energía total, así que son sus registros de energía en reposo y de energía activa juntos. Una misma muestra de energía activa forma parte, por tanto, de active_calories y de total_calories. Hasta 1000 registros nuevos por sincronización. En daily_totals solo se envía los días con energía en reposo.

Entrenamientos

Clave exercise: type, start_time, end_time y duration_seconds, a partir de los entrenamientos de Apple Health. type es la actividad en snake_case, como running, walking, downhill_skiing o hiit; other es el tipo Otro de Apple, o una actividad de un iOS más nuevo que la app. duration_seconds incluye las pausas, así que puede ser más largo que el tiempo de entrenamiento que muestra la app Salud. Android envía aquí, en cambio, un número como cadena de texto, como "56" para correr.

Cuerpo

Peso

Clave weight: kilograms, en un momento (time), con hasta 2 decimales, así que un peso introducido en libras sobrevive a la conversión.

Altura

Clave height: meters, en un momento.

Porcentaje de grasa corporal

Clave body_fat: percentage, de 0 a 100, en un momento.

Masa corporal magra

Clave lean_body_mass: kilograms, en un momento.

Corazón y signos vitales

Frecuencia cardíaca

Clave heart_rate: bpm, un número entero, en un momento, un registro por muestra. Hasta 1000 registros nuevos por sincronización. Cada muestra tiene su propio uuid; la forma <uuid>#<time> de Android no se aplica.

Frecuencia cardíaca en reposo

Clave resting_heart_rate: bpm, un número entero, en un momento.

Variabilidad de la frecuencia cardíaca

Clave heart_rate_variability: heart_rate_variability_millis, en un momento. Es SDNN, la medida que guarda Apple Health. Android envía RMSSD, la que guarda Health Connect, con la misma clave; no son el mismo número, así que mantenlos separados. Hasta 500 registros nuevos por sincronización.

Presión arterial

Clave blood_pressure: systolic y diastolic en mmHg, en un momento, por medición: los dos valores que una app guardó juntos. Si alguna app, algo poco habitual, los guarda por separado, se emparejan cuando llegan con menos de un segundo de diferencia. Un valor sin su otra mitad no se envía. El uuid es el de la muestra sistólica.

Temperatura corporal

Clave body_temperature: celsius, en un momento.

Temperatura corporal basal

Clave basal_body_temperature: celsius, en un momento.

Glucosa en sangre

Clave blood_glucose: mmol_per_liter, en un momento.

Oxígeno en sangre

Clave oxygen_saturation: percentage, de 0 a 100, en un momento.

Frecuencia respiratoria

Clave respiratory_rate: rate en respiraciones por minuto, en un momento. Hasta 500 registros nuevos por sincronización.

VO2 máx

Clave vo2_max: vo2_ml_per_min_per_kg, en un momento.

Sueño y mente

Sueño

Clave sleep: session_end_time, duration_seconds y stages, cada fase con su propio stage, sus horas, su uuid y su source. Apple Health no tiene sesiones de sueño, así que la app agrupa las muestras de fases en noches, y un hueco de más de una hora empieza una nueva.

  • Fases: light (la fase Core de Apple), deep, rem, awake, sleeping y unknown, que Android también envía, e in_bed, que solo envía un iPhone: el tiempo en la cama alrededor de las fases, no una fase en sí.
  • El uuid de una noche viene de su fase más temprana, así que no cambia mientras la noche crece. Sustituye la noche cuando vuelva más larga. Una fase agregada después vuelve a enviar la noche entera.
  • El source de la noche es la app o el dispositivo que registró la mayoría de sus fases.

Mindfulness

Clave mindfulness: start_time, end_time y duration_seconds, de las apps que escriben sesiones de atención plena en Apple Health. Sin title, que Android sí puede enviar.

Comida y bebida

Agua

Clave hydration: liters, en un intervalo. Es el agua de Apple Health.

Nutrición

Clave nutrition: calories, protein_grams, carbs_grams, fat_grams, name y 34 nutrientes más con las claves de Android, como dietary_fibre_g, sugars_g, sodium_mg y caffeine_mg, en un intervalo. Todos los campos son opcionales.

  • Un alimento que anotó una app, con todos sus nutrientes, es un solo registro, con su nombre cuando la app lo dio.
  • Los otros 34 nutrientes solo se leen de un alimento que también tiene energía, proteínas, carbohidratos o grasas, así que un café anotado solo con cafeína no se envía.
  • Apple Health no tiene ningún tipo para las grasas trans, las grasas insaturadas, la energía procedente de grasas, el ácido fólico ni meal_type, así que esos nunca vienen de un iPhone.

Seguimiento del ciclo

Menstruación

Un interruptor, dos claves. menstruation_flow tiene flow en un momento, con los valores del esquema compartido light, medium, heavy o unknown. menstruation_period solo tiene start_time y end_time: Apple Health no tiene un registro de periodo, así que la app deduce los periodos de los días consecutivos con flujo, y un hueco de hasta 48 horas salva un día sin anotar. El uuid de un periodo viene de su primer día de flujo, así que sustituye el periodo cuando vuelva más largo.

Manchado

Clave intermenstrual_bleeding: solo el campo time.

Resultado de prueba de ovulación

Clave ovulation_test: result en un momento: positive (pico de LH), high (pico de estrógenos), negative, inconclusive o unknown.

Calidad del moco cervical

Clave cervical_mucus: appearance y sensation en un momento. Apple Health no registra la sensación, así que sensation es siempre unknown.

Actividad sexual

Clave sexual_activity: protection_used en un momento: protected o unprotected cuando la app que lo escribió lo registró, unknown en caso contrario.

Por MQTT no se publican las entradas del seguimiento del ciclo, porque un topic retenido no es lugar para datos reproductivos; la temperatura corporal basal sí se publica. La integración de Home Assistant y un webhook las reciben todas.

Las cinco claves de Android que un iPhone nunca envía

Clave de AndroidPor qué no
speedLa app para iPhone todavía no lee la velocidad.
bone_massApple Health no tiene un tipo para la masa ósea.
body_water_massApple Health no tiene un tipo para el agua corporal.
skin_temperatureApple Health guarda la temperatura absoluta de la muñeca durante el sueño, no la variación respecto a un valor de referencia que lleva esta clave.
basal_metabolic_rateApple Health guarda la energía en reposo por intervalo, no una tasa por día. Sale como parte de total_calories.

Números, límites y resolución

  • Decimales. 3 para metros y litros; 2 para kilogramos, calorías, grados Celsius, mmol/L y los nutrientes; 1 para porcentajes, presión arterial, frecuencia respiratoria, HRV y VO2 máx. Los ceros finales se eliminan, así que 97.0 llega como 97. Los recuentos, las pulsaciones por minuto y las duraciones son números enteros.
  • Por sincronización. Hasta 1000 registros nuevos para la frecuencia cardíaca, los pasos y las calorías totales, 500 para la HRV y la frecuencia respiratoria, y 200 para cada uno de los demás tipos. La siguiente sincronización continúa donde se detuvo esta.
  • Resolución de datos. En Qué enviar, la frecuencia cardíaca, la HRV, la saturación de oxígeno y la frecuencia respiratoria se pueden enviar como una media por cada 1, 5 o 15 minutos o por hora, con un mínimo y un máximo; los pasos, la distancia y las dos calorías, como una suma. Todos los tipos empiezan en cada registro.

La página del payload de iOS tiene todos los detalles, y el JSON Schema de la app para Android cubre las dos apps. Para Android, consulta Tipos de datos de Health Connect, app por app.

Life Dashboard para iPhone

Activa tus tipos en Qué enviar y toca Vista previa del payload para ver lo que enviaría la siguiente sincronización.

Descárgala en App Store

6,99 €, pago único, en App Store, sin suscripción.

Compilar con Xcode

Consigue la app para iPhone Referencia del payload de iOS

La app de código abierto para iPhone que usa esta guía. Sin cuenta, y los datos solo van adonde tú indiques. Más sobre la app.

Preguntas frecuentes

¿Cuántos tipos de Apple Health lee la app para iPhone?

28, cada uno desactivado hasta que lo activas en Qué enviar. La menstruación envía dos claves, el flujo y los periodos, así que un iPhone envía 29 claves del payload.

¿Por qué el iPhone no envía la masa ósea ni la temperatura de la piel?

Apple Health no tiene un tipo para la masa ósea ni para el agua corporal, y guarda la temperatura absoluta de la muñeca durante el sueño en lugar de la variación respecto a un valor de referencia que lleva el payload compartido. La tasa metabólica basal sale dentro de total_calories.

¿La HRV de un iPhone es la misma que la de Android?

No. Apple Health guarda SDNN y Health Connect guarda RMSSD. Las dos llegan en heart_rate_variability_millis, pero son medidas distintas, así que no las promedies ni las compares.

¿Qué tipos se convierten en sensores en Home Assistant?

20 de los 28, con la presión arterial como dos sensores. Los entrenamientos tienen un sensor del último entrenamiento y los minutos de hoy y de ayer, y los entrenamientos y el mindfulness cuentan para las estadísticas del día, en horas. Desde la integración 1.2.0, tus comidas se suman en las calorías, las proteínas, los carbohidratos y las grasas que consumiste hoy. Las comidas sueltas y el seguimiento del ciclo no tienen sensor; un webhook los recibe completos.

¿Lee la app el tiempo de pantalla o el ECG?

No. El tiempo de pantalla no puede salir del iPhone: iOS lo muestra solo dentro de un sandbox que no puede enviar nada fuera. Todo lo que queda fuera de los 28 tipos se queda en Apple Health.