Sincronizar datos de Apple Health a REST API

Enviar datos de salud a un endpoint de REST API.

Last updated: February 6, 2026

On this page

Las automatizaciones de REST API te permiten exportar automáticamente tus datos de salud a cualquier servicio web que acepte solicitudes HTTP POST. Esto es ideal para integrar con backends personalizados, APIs de terceros o webhooks.

Resumen

Las automatizaciones de REST API envían tus datos de salud a un endpoint de URL especificado usando solicitudes HTTP POST. La automatización puede enviar datos en formato JSON o CSV, con encabezados configurables para autenticación y metadatos personalizados.

Casos de uso:

Integración con servicios backend personalizados
Envío de datos a webhooks
Sincronización con APIs de terceros
Creación de dashboards personalizados o plataformas de análisis

Características principales:

Soporta formatos JSON y CSV
Encabezados HTTP personalizados para autenticación
Tiempo de espera de solicitud configurable
Exportación manual de datos históricos

Limitaciones

Acceso a datos de salud: Las aplicaciones no pueden acceder a los datos de salud mientras el iPhone está bloqueado. Las automatizaciones solo se ejecutarán durante los períodos en que tu dispositivo esté desbloqueado. Esto puede afectar la frescura de los datos. Consulta las instrucciones para sincronización manual para mantener los datos actualizados.
Procesamiento en segundo plano: iOS limita el procesamiento en segundo plano para preservar la vida de la batería. Las automatizaciones dependen de Actualización de aplicaciones en segundo plano y pueden no ejecutarse inmediatamente si:
- La Actualización de aplicaciones en segundo plano está deshabilitada para la aplicación
- El dispositivo está en Modo de bajo consumo
- El dispositivo ha estado inactivo durante períodos prolongados
- Los recursos del sistema están limitados
- Múltiples aplicaciones compiten por el tiempo de ejecución en segundo plano

Requisitos previos

Un endpoint de URL válido que acepte solicitudes HTTP POST
Credenciales de autenticación (si las requiere tu endpoint)
Conectividad de red para alcanzar tu endpoint

Configuración

Navega a la pantalla de Exportaciones automatizadas desde la navegación principal, luego toca "Nueva automatización" y selecciona "REST API" como Tipo de automatización.

Nombre de automatización

Ingresa un nombre descriptivo para tu automatización (por ejemplo, "Mi API backend", "Integración de webhook").

Notificaciones

Configura cuándo deseas recibir notificaciones:

Notificar en actualización de caché - Recibe una notificación cuando se actualicen los datos en caché
Notificar cuando se ejecute - Recibe una notificación cada vez que la automatización se ejecute

Configuración de URL

Ingresa la URL completa donde deseas enviar tus datos de salud. Debe ser una URL completa que incluya el protocolo (http:// o https://).

URLs de ejemplo:

https://api.example.com/health-data
https://webhook.site/your-unique-id
http://localhost:3000/api/health

Nota: La URL debe ser válida y accesible desde tu dispositivo. Las URLs inválidas impedirán que la automatización se ejecute.

Tiempo de espera de solicitud

Selecciona un intervalo de tiempo de espera para las solicitudes HTTP. Esto determina cuánto tiempo esperará la aplicación una respuesta antes de considerar que la solicitud falló.

Encabezados HTTP

Agrega encabezados HTTP personalizados para autenticación o metadatos. Los casos de uso comunes incluyen:

Claves de API: X-API-Key: your-api-key
Tokens de autorización: Authorization: Bearer your-token
Anulaciones de tipo de contenido: Content-Type: application/json

Para agregar encabezados:

Toca "Agregar encabezados"
Ingresa la clave del encabezado en el campo izquierdo
Ingresa el valor del encabezado en el campo derecho
Repite para encabezados adicionales

Importante: Cada clave de encabezado debe tener un valor correspondiente. Los encabezados vacíos serán ignorados.

Configuración de tipo de datos

Tipo de datos

Selecciona qué tipo de datos de salud exportar:

Métricas de salud - Pasos, frecuencia cardíaca, sueño y otras mediciones de salud
Entrenamientos - Actividades de ejercicio y fitness
Síntomas - Síntomas y condiciones de salud
ECG - Lecturas de electrocardiograma
Notificaciones de frecuencia cardíaca - Eventos de frecuencia cardíaca alta/baja
Estado de ánimo - Entradas de estado de ánimo y estado mental (iOS 18.0+)
Seguimiento de ciclo - Datos de ciclo menstrual y salud reproductiva
Medicamentos - Registros de medicamentos y adherencia (iOS 26.0+)

Configuración de métricas de salud

Cuando se selecciona Métricas de salud:

Seleccionar métricas de salud - Elige qué métricas específicas incluir. Puedes seleccionar todas las métricas disponibles o elegir específicas.

Consejo: Seleccionar solo las métricas que necesitas puede mejorar el tiempo de procesamiento y reducir el tamaño de los datos.

Fuentes preferidas - Configura qué fuentes de datos tienen prioridad cuando múltiples fuentes proporcionan la misma métrica.

Configuración de entrenamientos

Cuando se selecciona Entrenamientos:

Incluir datos de ruta - Activa para incluir rutas para entrenamientos que tienen datos de ubicación.

Incluir métricas de entrenamiento - Activa para incluir métricas de salud recopiladas durante los entrenamientos (frecuencia cardíaca, calorías, etc.).

Agrupación de tiempo (métricas de entrenamiento) - Cuando se usa Versión de exportación 2 e Incluir métricas de entrenamiento está habilitado:

Minutos - Agrupa las métricas de entrenamiento por minuto
Segundos - Agrupa las métricas de entrenamiento por segundo

Configuración de exportación

Formato de exportación

Selecciona el formato para tus datos exportados:

Formato JSON - Proporciona estructuras de datos detalladas con objetos anidados. Mejor para APIs, bases de datos y aplicaciones que necesitan datos estructurados. El formato JSON incluye información más detallada para tipos de datos complejos como fases de sueño y lecturas de AFib.
Formato CSV - Proporciona datos tabulares que se pueden importar fácilmente en aplicaciones de hojas de cálculo. Mejor para análisis de datos simples o cuando tu endpoint espera datos CSV.

Nota: El encabezado Content-Type se establece automáticamente en application/json para exportaciones JSON y multipart/form-data para exportaciones CSV.

Versión de exportación

Selecciona una Versión de exportación. El versionado permite transicionar entre versiones actualizadas de la exportación a tu propio ritmo y minimiza los cambios que rompen los flujos de trabajo.

Versión 1 - Formato heredado, úsalo si tienes flujos de trabajo existentes que dependen de este formato
Versión 2 - Formato actual con datos de entrenamiento mejorados y opciones de metadatos más detalladas

Rango de fechas

Selecciona cuándo se deben exportar los datos:

Predeterminado - Sincroniza datos para el día anterior completo más datos hasta la fecha y hora actuales
Desde última sincronización - En cada sincronización, exporta todos los datos desde la última vez que se ejecutó la exportación hasta la fecha y hora actuales
Hoy - Sincroniza todos los datos para la fecha actual hasta la hora actual
Ayer - Sincroniza todos los datos para el día anterior completo
Últimos 7 días - Sincroniza datos para los últimos siete días completos

Resumir datos

Cuando uses formato JSON con tipo de datos Métricas de salud, activa o desactiva Resumir datos.

Activado - Proporciona resúmenes de datos agregados
Desactivado - Proporciona datos desagregados cuando sea posible, mostrando puntos de datos individuales

Nota: Esta configuración solo se aplica al formato JSON con Métricas de salud. Los datos siempre se agregan cuando se usa formato CSV o cuando se seleccionan múltiples métricas.

Agrupación de tiempo

Cuando uses formato JSON con Resumir datos habilitado, selecciona cómo se deben agregar los datos.

Nota: El formato CSV siempre agrega datos. La agregación a nivel de minuto y segundo puede aumentar significativamente el tiempo de procesamiento y el tamaño de los datos.

Solicitudes por lotes

Cuando uses formato JSON, activa Solicitudes por lotes para enviar datos en lotes a través de múltiples solicitudes en lugar de una sola carga útil.

Activado - Distribuye datos en múltiples solicitudes para evitar cargas útiles excesivamente grandes
Desactivado - Envía todos los datos en una sola solicitud

Cadencia de sincronización

Configura con qué frecuencia la automatización debe cargar datos:

Selecciona un número e intervalo.

Pruebas y verificación

Pruebas manuales

Toca "Exportación manual" en la pantalla de configuración de automatización
Selecciona un rango de fechas
Toca "Exportar" para enviar una solicitud de prueba
Verifica tu endpoint para confirmar que se recibieron los datos

Ver registros de actividad

Toca "Ver registros de actividad" en la pantalla de configuración de automatización
Revisa las ejecuciones recientes de automatización
Verifica si hay errores o advertencias
Verifica las marcas de tiempo de solicitud y el estado de respuesta

Verificar formato de datos

La aplicación incluye automáticamente estos encabezados en cada solicitud:

Content-Type - Establecido según el formato de exportación
automation-name - El nombre de tu automatización
automation-id - Identificador único para la automatización
automation-aggregation - La agrupación de tiempo seleccionada
automation-period - El rango de fechas seleccionado
session-id - Identificador único para cada solicitud

Solución de problemas

Problemas comunes

Datos no recibidos en el endpoint

Verifica que la URL del endpoint sea correcta
Verifica que tu endpoint acepte solicitudes POST
Revisa los encabezados de autenticación
Verifica los registros del endpoint para solicitudes entrantes
Verifica la conectividad de red

Consejos y mejores prácticas

Rendimiento:
- Usa agrupación de tiempo apropiada para equilibrar detalle vs. tamaño de datos
- Selecciona solo las métricas que necesitas
Confiabilidad:
- Establece valores de tiempo de espera apropiados según el tiempo de respuesta de tu endpoint
- Monitorea los registros de actividad regularmente
Formato de datos:
- Usa JSON para datos estructurados y APIs
- Usa CSV para análisis de datos simples o integración con hojas de cálculo
- Considera solicitudes por lotes para conjuntos de datos grandes o procesamiento separado