Centro de ayuda HealthyApps
Español
Centro de ayuda
Sitio principal ↗

Buscar temas de ayuda

Sincronizar datos de Apple Health con API REST

Envía datos de salud a un endpoint de API REST.

Última actualización: 31 de octubre de 2026

En esta página
Abrir la automatizaciónNombre, estado y notificacionesConfigurar el endpoint
Ajustes del tipo de datos Ajustes del tipo de datos Métricas de saludEntrenamientos
Ajustes de exportación Ajustes de exportación Formato de exportaciónVersión de exportaciónIntervalo de fechasResumir datos y agrupación temporal
Solicitudes por lotes y cargas grandesProgramar recordatoriosFrecuencia de sincronización y guardarEncabezados de la solicitudExportar datos históricos o omitidosSolución de problemas

Envía exportaciones de salud a un endpoint que acepte solicitudes HTTP POST.

Importante — limitaciones de las automatizaciones: El dispositivo debe estar desbloqueado para leer datos de salud, e iOS no garantiza ejecuciones en segundo plano a la frecuencia que elijas. Revisa las limitaciones de las automatizaciones antes de confiar en exportaciones automáticas.

Abrir la automatización

Abre Exportar → Automatizado en iPhone, o Automatizaciones en la barra lateral del iPad. Selecciona Nueva Automatización, o abre una existente para editarla.

Nombre, estado y notificaciones

Introduce un nombre que identifique esta automatización. Activado permite ejecuciones automáticas; déjalo desactivado hasta que estés listo.

Elige las notificaciones de ejecución que quieras:

  • Notificar al actualizar la caché indica que se prepararon los datos de exportación.
  • Notificar al ejecutarse indica una carga correcta en tu endpoint.

Permite las notificaciones cuando se te pida. Estas notificaciones informan de la actividad; no programan una ejecución.

Configurar el endpoint

  1. Elige API REST como Tipo de automatización.
  2. Introduce una URL accesible desde tu iPhone o iPad, por ejemplo https://api.example.com/health-data.
  3. Añade la autenticación necesaria en Encabezados HTTP. Por ejemplo, usa Authorization como clave y Bearer YOUR_TOKEN como valor.
  4. Elige un Tiempo de espera de la solicitud adecuado para tu endpoint.

Cada encabezado necesita clave y valor. Para un servidor en otro dispositivo, usa su dirección de red accesible en lugar de localhost.

Ajustes del tipo de datos

Selecciona un Tipo de datos para esta automatización: Métricas de salud, Entrenamientos, Síntomas, ECG, Notificaciones de frecuencia cardiaca, Estado de ánimo, Seguimiento del ciclo o Medicamentos. Estado de ánimo requiere iOS 18 o posterior; Medicamentos requiere iOS 26 o posterior y acceso aparte a medicamentos.

Métricas de salud

Elige Métricas de salud, abre Seleccionar métricas de salud y selecciona las mediciones que necesites.

Para limitar las lecturas a apps o dispositivos concretos, abre Orígenes preferidos, elige una métrica y selecciona sus orígenes. Todos permite todos los orígenes que no se hayan excluido. Usa Orígenes excluidos para ignorar un origen en las métricas de salud de esta automatización. Las exclusiones tienen prioridad; no se sustituye un origen no seleccionado cuando el preferido no tiene datos. Selecciona Guardar para aplicar las opciones de origen o Cancelar para descartarlas.

Entrenamientos

Elige Entrenamientos para exportar registros de entrenamiento. Incluir datos de ruta añade los puntos de ruta disponibles a los datos JSON del entrenamiento. No crea cargas GPX independientes.

Para la Versión 2, activa Incluir métricas del entrenamiento para añadir lecturas como frecuencia cardiaca, energía activa y pasos. Elige Minutos o Segundos para la Agrupación temporal de métricas del entrenamiento; los segundos producen más detalle y exportaciones más grandes. La Versión 1 siempre incluye métricas del entrenamiento.

Ajustes de exportación

Formato de exportación

  • JSON conserva datos estructurados para integraciones y análisis.
  • CSV crea archivos tabulares para hojas de cálculo.
  • Markdown crea encabezados y tablas legibles para notas y archivos.

Versión de exportación

Elige Versión 2 para la estructura de datos actual. Usa Versión 1 cuando un flujo existente dependa del formato anterior.

Intervalo de fechas

Selección Datos incluidos
Predeterminado El día anterior y hoy hasta la hora de la ejecución
Desde la última sincronización Desde la sincronización anterior hasta la hora de la ejecución
Hoy Hoy hasta la hora de la ejecución
Ayer El día completo anterior
Últimos 7 días Los siete días completos anteriores

Resumir datos y agrupación temporal

Para JSON + Métricas de salud, activa Resumir datos para combinar lecturas en grupos temporales, o desactívalo para lecturas individuales cuando estén disponibles. El resumen depende de la métrica—por ejemplo, los pasos se suman y las lecturas de peso se promedian. Las exportaciones CSV de métricas de salud usan datos resumidos.

Cuando esté disponible Agrupación temporal, elige cuánto detalle conservar. Los grupos por hora o por día producen menos filas que los de minuto o segundo. Las opciones disponibles dependen del intervalo de fechas y del formato. La agrupación temporal de entrenamientos se configura por separado en Entrenamientos.

Solicitudes por lotes y cargas grandes

Para API REST + JSON, activa Solicitudes por lotes para enviar datos en varias solicitudes. Úsalo cuando tu endpoint rechace cuerpos grandes o las solicitudes grandes agoten el tiempo de espera. El servicio receptor debe gestionar cada solicitud por separado.

Los lotes no están disponibles para CSV ni Markdown. Reducen el tamaño de cada solicitud, pero no la cantidad de datos de salud que el dispositivo debe leer. Consulta Rendimiento si la preparación es lenta.

Programar recordatorios

Si quieres un aviso para desbloquear y abrir la app, activa Activar recordatorios. Elige Por hora, Todos los días o Días seleccionados y configura el minuto, la hora y los días según corresponda. Permite el acceso a notificaciones cuando se te pida; si se deniega, usa Abrir la configuración de notificaciones.

Un recordatorio no ejecuta la automatización ni confirma una sincronización correcta. Tócalo para abrir la automatización, o usa Abrir y sincronizar en la notificación para solicitar una ejecución. La automatización debe estar habilitada; un recordatorio puede aparecer incluso después de una ejecución en segundo plano correcta. Los cambios de recordatorio se aplican al guardar.

Frecuencia de sincronización y guardar

Elige un número y Minutos, Horas, Días o Semanas en Frecuencia de sincronización—por ejemplo, cada 15 minutos. Es una cadencia deseada en segundo plano, no un horario garantizado.

El dispositivo debe estar desbloqueado cuando se lean los datos de salud. Activa la Actualización en segundo plano para Health Auto Export y desactiva el modo de bajo consumo para las ejecuciones automáticas. iOS puede retrasar las ejecuciones si el dispositivo ha estado inactivo o los recursos del sistema son limitados.

Activa Activado cuando estés listo para ejecuciones automáticas y selecciona Actualizar para guardar la automatización. Puedes cargar de inmediato un intervalo de fechas con los pasos siguientes.

Encabezados de la solicitud

La app establece Content-Type para el formato elegido e incluye:

Encabezado Significado
automation-name Nombre de la automatización
automation-id Identificador de la automatización
automation-aggregation Agrupación temporal seleccionada
automation-period Intervalo de fechas seleccionado
session-id Identificador de la solicitud

Exportar datos históricos o omitidos

Usa Carga manual al configurar por primera vez la automatización para exportar datos históricos, o más adelante para cubrir fechas que la sincronización automática no alcanzó. También puedes usarla para comprobar la configuración.

  1. Abre la automatización y selecciona Carga manual en Exportar datos existentes.
  2. Establece las fechas de Inicio y Fin y selecciona Iniciar exportación.
  3. Comprueba la solicitud recibida en tu endpoint, los encabezados y el cuerpo.

Solución de problemas

  • No se recibe ninguna solicitud: Comprueba la URL, la accesibilidad de la red y los registros del servidor.
  • Error de autenticación: Comprueba la clave del encabezado, el token y los permisos del endpoint.
  • Carga rechazada o tiempo de espera agotado: Comprueba los límites de tamaño del servidor, usa lotes para JSON o reduce el tamaño de la exportación.

Abre la automatización y selecciona Ver registros de actividad para revisar una ejecución. Las advertencias señalan posibles problemas como una recuperación de datos lenta; los errores identifican pasos fallidos. Para ayuda al informar de un problema, consulta Obtener ayuda.