Automatización con enlace profundo
Crea una automatización de API REST abriendo una URL en tu iPhone o iPad.
Última actualización: 31 de octubre de 2026
En esta página
Crea una automatización de API REST abriendo una URL en tu iPhone o iPad. Los enlaces profundos no configuran otros destinos.
Formato de URL
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url es obligatorio. Proporciona un name descriptivo; si se omite, el valor predeterminado es Automation. Los nombres de parámetro no distinguen mayúsculas. Codifica en URL los valores de parámetro que contengan espacios o caracteres reservados.
Abre la URL en tu dispositivo, o usa Abrir URLs en Atajos. Revisa la automatización creada en Health Auto Export antes de habilitarla.
Referencia de parámetros
Los booleanos aceptan true/false, 1/0 o yes/no. Establece datatype antes de sus opciones específicas de datos, y format antes de aggregatedata, para que las selecciones posteriores no sustituyan ajustes anteriores.
Ajustes básicos
| Parámetro | Valores o significado | Predeterminado |
|---|---|---|
url |
URL del endpoint accesible desde tu dispositivo | Obligatorio |
name |
Nombre de automatización no vacío | Automation |
enabled |
Habilitar ejecuciones automáticas | false |
datatype |
Tipo de datos listado abajo | healthMetrics |
format |
json, csv, markdown o md |
json |
exportversion |
v1, v2, 1 o 2 |
v2 |
period |
none, lastsync, today, yesterday, previous7days |
none |
requesttimeout |
Segundos enteros, 60–86400 | 60 |
headers |
Pares clave/valor separados por comas | Ninguno |
batchrequests |
Booleano; solo JSON | false |
Los tipos de datos válidos son healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking y medications. Estado de ánimo requiere iOS 18 o posterior; las exportaciones de medicamentos requieren iOS 26 o posterior.
Para el significado de los intervalos de fechas, consulta Intervalo de fechas. Todos los enlaces profundos crean automatizaciones de API REST; no hay parámetro exportDestination.
Métricas de salud
| Parámetro | Valores o significado | Predeterminado |
|---|---|---|
metrics |
Nombres exactos de métricas separados por comas, como Step Count,Heart Rate |
Todas las métricas disponibles |
aggregatedata |
Booleano; usa false para lecturas individuales cuando se admita |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
Booleano que controla el resumen del sueño | true |
metrics, aggregatedata e interval aplican a métricas de salud. La selección CSV activa el resumen; usa JSON para lecturas individuales. Indica el resumen deseado de forma explícita al generar enlaces.
Entrenamientos
| Parámetro | Valores o significado | Predeterminado cuando datatype=workouts |
|---|---|---|
includeroutes |
Booleano | true |
includeworkoutmetadata |
Booleano | true |
workoutsmetadatainterval |
minutes o seconds; Versión 2 |
minutes |
workouttypes |
Identificadores de tipo de entrenamiento de Apple sin signo, separados por comas | Todos los tipos |
No incluyas opciones de agregación de métricas de salud en un enlace de entrenamiento.
Cadencia y notificaciones
| Parámetro | Valores o significado | Predeterminado |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
Número entero positivo de intervalos | 5 |
notifyonupdate |
Booleano; notificar tras preparar los datos | true |
notifywhenrun |
Booleano; notificar tras una acción correcta en el destino | true |
La cadencia sigue sujeta a los límites de segundo plano y de datos de salud; no es un horario exacto.
Autenticación y codificación
El valor de headers consiste en claves y valores alternados:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
Cada clave requiere un valor. Las comas separan los pares, así que evita valores de encabezado con comas en este formato de enlace. Codifica los espacios como %20, los signos más como %2B y los ampersands como %26. Codifica la URL completa del endpoint cuando tenga sus propios parámetros de consulta.
Ejemplos
Métricas seleccionadas, resumidas por hora
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours
Entrenamientos con rutas
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes
Ambos ejemplos dejan las ejecuciones automáticas desactivadas hasta que revises y habilites la automatización.
Solución de problemas
- Error de URL o parámetro: Empieza con la URL mínima, comprueba la ortografía y la codificación, y luego agrega opciones de una en una.
- Métrica no válida: Usa el nombre exacto de la métrica, incluidos espacios y mayúsculas.
- Error de agregación: Usa opciones de métricas de salud solo con
datatype=healthMetrics. - Error de ajustes de entrenamiento: Usa opciones de entrenamiento con
datatype=workouts; la agrupación en segundos requiere la Versión 2. - Error de lotes: Establece
format=jsono desactivabatchrequests. - Cadencia/tiempo de espera no válidos: Usa los intervalos admitidos, una cantidad positiva y un tiempo de espera de 60 a 86400 segundos.
- URL demasiado larga: Reduce la lista de métricas/encabezados o configura el resto en la app.
Tras la creación, usa API REST — Exportar datos históricos o omitidos para cargar un intervalo seleccionado o comprobar la configuración.