Por qué hace falta una app en el iPhone
Apple Health no tiene API web. Vive en el iPhone, y las apps lo leen a través de HealthKit de Apple, así que algo en el iPhone tiene que leerlo y reenviarlo. La app Life Dashboard hace eso y envía directamente a las URL que introduces. No hay cuenta ni ningún servidor de Life Dashboard de por medio, y la app no tiene analíticas, informes de fallos ni anuncios. Una API web para Health Connect o Apple Health lo explica con más detalle.
Qué necesitas
- Un iPhone con iOS 17 o posterior, y Life Dashboard para iPhone. Está en App Store por 6,99 € (5,99 USD), pago único, sin suscripción. Compilarla a partir del código fuente con Xcode no cuesta nada más si ya tienes una suscripción al Apple Developer Program.
- Un servidor que acepte un POST con JSON. Usa
https://. iOS solo permitehttp://sin cifrar hacia una dirección IP, un nombre.localo un nombre sin punto, pensado para tu propia red.
Configuración paso a paso
- En la configuración inicial de la app, introduce tu URL como URL del webhook. Más adelante, toca Agregar destino en la pestaña Salud, introdúcela y toca Agregar webhook. Puedes agregar varias; una sincronización cuenta como entregada cuando una de ellas la acepta.
- Opcional: toca el destino en la pestaña Salud. En Encabezados personalizados, toca Agregar un encabezado para un encabezado
Authorizationo una clave de API. Introduce un Secreto de firma HMAC que tu servidor también conozca, o toca Generar y Copiar secreto. Después toca Guardar. Cada dirección tiene su propio secreto y sus propios encabezados. - Toca Ping de prueba en la configuración inicial, o Enviar prueba en la hoja del destino. Envía un payload pequeño con
"test": truey sin registros, usando lo que está guardado. Si tu servidor está en casa, permite Red local cuando iOS lo pida. - En Qué enviar, activa tus tipos y permite el acceso a Apple Health. Ahí mismo, Vista previa del payload muestra los últimos 7 días tal como quedaría el payload, y Sincronizar ahora, en la pestaña Salud, envía lo nuevo. La primera sincronización de un tipo envía sus últimos 7 días.
- Para los datos más antiguos, toca Enviar historial en Qué enviar y elige hasta dónde retroceder, desde 30 días hasta Todo el historial.

Cómo es el POST
Cada petición es un POST con JSON. Un payload abreviado, de la página del payload de iOS:
{
"timestamp": "2026-02-05T12:00:00Z",
"timezone": "Europe/Amsterdam",
"app_version": "1.9.0",
"source": "healthkit_ios",
"sequence": 42,
"steps": [
{
"count": 1234,
"start_time": "2026-02-05T08:00:00Z",
"end_time": "2026-02-05T09:00:00Z",
"uuid": "5B7A0C2E-8F3D-4B1A-9C6E-2D4F8A1B3C5D",
"source": "Alex's iPhone"
}
],
"daily_totals": [
{ "date": "2026-02-05", "steps": 8421, "distance_meters": 6210.4 }
]
}
source, en el nivel superior, eshealthkit_ios, donde la app para Android dicehealth_connect.timezonees la zona horaria del iPhone en el momento en que se creó el payload. Todas las horas del payload están en UTC, y esta es la zona con la quedaily_totalscorta sus días, así que un receptor sabe cuál es el día local después de un cambio al horario de verano o de un viaje. Todos los payloads la llevan desde la versión 1.9.0.sequencesube de uno en uno con cada payload que crea el iPhone, y un reintento conserva el número con el que se creó.- Cada registro tiene un
uuid, el de la propia muestra de Apple Health, que no cambia en toda la vida del registro, y unsource: el nombre que Apple Health da a la app o al dispositivo que lo escribió. Para los datos que registra el propio iPhone o el reloj, es el nombre del dispositivo, que a menudo incluye el nombre de su propietario. daily_totalscontiene los pasos, la distancia y las calorías por día local, para hoy y los dos días anteriores, calculados con las estadísticas propias de Apple Health. Un paseo registrado tanto por el iPhone como por el reloj cuenta ahí una sola vez; al sumar los registros en bruto se cuenta dos veces.
Las claves, los campos y las unidades son los de la app para Android. La referencia del payload de la app para Android documenta cada tipo, y su JSON Schema cubre las dos apps. Tipos de datos de Apple Health enumera lo que envía un iPhone, clave por clave.
Comprueba la firma
Con un secreto definido, cada POST lleva X-Signature: sha256=<hex>, el HMAC-SHA256 del cuerpo en bruto de la petición con tu secreto como clave. Es el esquema de la app para Android, así que una sola comprobación sirve para los dos teléfonos. Calcúlalo sobre los bytes tal como llegaron, antes de interpretarlos, compara en tiempo constante y responde 401 si no coincide. En Node.js:
const crypto = require('crypto');
function verifySignature(req, secret) {
const expected = 'sha256=' + crypto
.createHmac('sha256', secret)
.update(req.rawBody) // the exact raw request body bytes
.digest('hex');
const actual = req.get('X-Signature') || '';
return actual.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(actual), Buffer.from(expected));
}
En Python:
expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(expected.encode(), presented.encode())
Para un servidor detrás de un proxy inverso que exige un certificado de cliente, impórtalo como archivo .p12 en Más > Avanzado. Se queda en el Llavero del iPhone, y lo recibe cada webhook cuyo servidor pide un certificado, también en segundo plano.
Los reintentos y la cola
- Reintentos. Cualquier 2xx cuenta como entregado. Un error de red, un tiempo de espera agotado, un 408, un 429 o un 5xx se intenta hasta 3 veces en total, con 1 y luego 2 segundos de separación. Otros errores, como 401 o 404, fallan al momento. Un intento se abandona cuando la conexión lleva 10 segundos parada, así que responde primero y guarda después.
- La cola. Cada payload entra en la cola del iPhone antes de enviarse, así que una sincronización que iOS corta a medias no pierde nada. Uno que no se entregó vuelve a salir cuando regresa la red, en la siguiente sincronización o con Reintentar ahora, el más antiguo primero, a las URL y con los encabezados configurados en ese momento. La cola se detiene en el primer payload que falla, así que el resto conserva su orden.
- Payloads rechazados. Un payload que tu servidor rechaza con 400, 413 o 422 no retiene a los que van detrás. Se queda en la cola y se vuelve a ofrecer una vez al día. Los payloads que entraron en la cola después pueden entonces llegar antes: usa
sequencepara resolver el orden. - Payloads antiguos y descartados. Un payload de más de 7 días se descarta cuando tu servidor responde con un error a su siguiente entrega, nunca mientras el iPhone está sin conexión. La cola admite hasta 700 payloads; pasado ese número, se va el más antiguo. Cada payload descartado recibe una fila en la pestaña Logs y una notificación.
- Las redirecciones solo se siguen dentro del mismo host. Una redirección a otro host, como una página de inicio de sesión delante de tu servidor, cuenta como una entrega fallida, y el log nombra el host al que apuntaba.

Registros borrados
Un registro borrado en Apple Health no deja nada que una sincronización pueda leer, así que la app sigue el registro de borrados del propio Apple Health y nombra lo que ya no está en el siguiente payload, con la clave bajo la que llegó el registro y el uuid con el que se entregó:
"deleted_records": [
{ "type": "nutrition", "uuid": "84E37E8A-1C2D-4E5F-8A9B-0C1D2E3F4A5B" }
]
- Cuando un borrado es el único cambio, la sincronización envía un payload con
deleted_recordsy sin registros. - Apple Health nunca edita un registro en el sitio. Una app que edita uno lo borra y guarda otro nuevo con un
uuidnuevo, así que una edición llega como un borrado más un registro nuevo. - Un borrado de sueño nombra una fase, no la noche. Quita esa fase, o sustituye las noches que cubre un payload más reciente.
deletions_unavailableenumera las claves de las que un payload no puede responder, por ejemplo cuando Apple Health no contestó a tiempo o un tipo llevaba más de 7 días sin leerse. Concilia esas con un backfill, el envío de todo tu historial anterior.
Cuándo envía
En Cuándo enviar, define un intervalo de 15 minutos o más, 60 de forma predeterminada, u horas fijas del día, en los días que elijas, con horas de silencio. iOS decide cuándo se ejecuta una app en segundo plano, así que una hora fija significa "no antes de". Apple Health también despierta la app cuando un tipo activado tiene datos nuevos, como mucho con la frecuencia que Apple permite para ese tipo. La actualización en segundo plano tiene que estar activada para la app; el modo de bajo consumo la desactiva.
Para una sincronización en un minuto exacto, crea una automatización de Atajos que ejecute Sincronizar datos de salud a esa hora. La misma acción funciona al llegar a casa, por voz con Siri, desde el widget de la pantalla de inicio y desde un control del Centro de control en iOS 18 y posteriores. Envía lo que está en la cola y lo nuevo.
iOS cifra Apple Health mientras el iPhone está bloqueado, así que una sincronización que empieza en ese momento espera al desbloqueo.

Backfill
Enviar historial, en Qué enviar, envía el periodo que elijas, desde 30 días hasta todo el historial, en ventanas de 3 días, la más antigua primero, con los campos backfill, window_start, window_end y window_complete. Los registros son los mismos que envía una sincronización, uuid incluido, así que lo que se solapa se deduplica. window_complete es siempre false desde un iPhone, porque Apple Health no le dice a una app qué tipos no puede leer. Los payloads de backfill van solo a los webhooks, nunca a MQTT ni a la cola.
Receptores que funcionan
- El stack Life Dashboard. Un receptor que comprueba
X-Signature, Postgres y dashboards de Grafana, desde un solo archivo compose. Escanea su código QR de vinculación en la app. Consulta el stack Life Dashboard. - n8n. Un nodo Webhook con Raw Body activado, una comprobación de la firma en un nodo Code y un 204. Apple Health a n8n tiene el workflow.
- Node-RED. Un nodo http in con Do not parse request body activado (Node-RED 4.1 o posterior) entrega los bytes en bruto para el HMAC.
- Home Assistant. La integración Life Dashboard convierte el payload en sensores y estadísticas a largo plazo.
- Un script tuyo. La referencia del payload de Android tiene receptores de ejemplo en Python y Node.js.
Guárdalo
- Haz un upsert de cada registro con su clave del payload y su
uuid. Un registro puede llegar dos veces: un backfill vuelve a enviar su intervalo, y una entrega que iOS cortó se envía otra vez desde la cola. Una misma muestra de energía activa cuenta tanto paraactive_caloriescomo paratotal_calories, así que usa las dos cosas como clave. - Guarda
daily_totalscomo una fila por fecha, tomada del payload con elsequencemás alto que traía esa fecha. - El
uuidde una noche de sueño viene de su fase más temprana, así que no cambia mientras la noche crece: sustituye la noche cuando vuelva más larga. - Borra lo que nombra
deleted_records, portypeyuuid, e ignora unuuidque no tengas.
En qué se diferencia un payload de iPhone del de Android
- La variabilidad de la frecuencia cardíaca (HRV) es SDNN, la medida que guarda Apple Health. Android envía RMSSD bajo la misma clave; no son el mismo número.
- El
typede un entrenamiento es un nombre comorunningohiit; Android envía un número como cadena. - Las fases del sueño incluyen
in_bed, el tiempo en la cama alrededor de las fases, que solo envía un iPhone. - No hay payload de tiempo de pantalla ni bloque
_diagnostics.
Un receptor escrito para Android funciona sin cambios, siempre que trate esas diferencias como opcionales. La página del payload de iOS enumera todas las diferencias.
Life Dashboard para iPhone
Instala la app, agrega tu URL y toca Ping de prueba. La página del payload de iOS enumera todo lo que envía un iPhone.
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
¿Puedo exportar Apple Health automáticamente, sin abrir la app?
Sí. Una vez configurada, la app sincroniza en segundo plano según tu horario, y Apple Health la despierta cuando hay datos nuevos. El iPhone tiene que estar desbloqueado para que una sincronización lea Apple Health, e iOS elige el momento exacto. Para un minuto fijo, usa una automatización de Atajos con Sincronizar datos de salud.
¿Puedo ver el JSON antes de escribir un receptor?
Sí. Vista previa del payload, en Qué enviar, muestra los últimos 7 días como un payload, Copiar JSON lo pone en el portapapeles y Compartir lo entrega como un archivo .json. Exportar datos, en Más, guarda lo mismo con Exportar JSON, o con Exportar CSV como una fila por registro.
¿Cómo evito contar los pasos dos veces?
Usa daily_totals para los pasos, la distancia y las calorías. Se cuentan como los cuenta la app Salud, así que un iPhone y un reloj que registraron el mismo paseo lo cuentan una sola vez.
¿Sirve el mismo receptor para un teléfono Android?
Sí. Las dos apps envían las mismas claves, las mismas unidades y la misma firma. Distínguelas por el source de nivel superior: healthkit_ios o health_connect. Health Connect a un webhook cubre la parte de Android.
¿Envía la app algo al desarrollador?
No. La app no tiene analíticas, informes de fallos ni anuncios, y no hay ningún servidor de Life Dashboard. Los datos van solo a las URL, al broker o al Home Assistant que tú configures.