Centro de ayuda HealthyApps
Español (Latinoamérica)
Centro de ayuda
Sitio principal ↗

Buscar temas de ayuda

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
Formato de URL
Referencia de parámetros Referencia de parámetros Ajustes básicosMétricas de saludEntrenamientosCadencia y notificaciones
Autenticación y codificación
Ejemplos Ejemplos Métricas seleccionadas, resumidas por horaEntrenamientos con rutas
Solución de problemasDocumentación relacionada

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=json o desactiva batchrequests.
  • 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.

Documentación relacionada