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

Buscar temas de ayuda

Métricas de salud - Formato de exportación JSON

Documentación de la estructura de métricas de salud en exportaciones JSON

Última actualización: 31 de octubre de 2026

En esta página
Formato del nombre de la métrica
Estructura Estructura Campos comunes
Formatos especiales de métricas Formatos especiales de métricas Presión arterialFrecuencia cardiacaVariabilidad de la frecuencia cardiacaAnálisis del sueñoGlucosa en sangreNutriciónActividad sexualLavado de manosCepillado de dientesAdministración de insulina
Documentación relacionada

Las exportaciones JSON almacenan las métricas de salud en el array metrics.

Formato del nombre de la métrica

Todos los nombres de métricas en las exportaciones JSON usan el formato snake_case (minúsculas con guiones bajos). Por ejemplo:

  • "Step Count" se convierte en "step_count"
  • "Blood Pressure" se convierte en "blood_pressure"
  • "Heart Rate" se convierte en "heart_rate"
  • "Walking + Running Distance" se convierte en "walking_running_distance"

Estructura

El array metrics contiene objetos, cada uno representando un tipo específico de métrica de salud. La mayoría de las métricas de salud siguen una estructura común:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

Campos comunes

  • name (String): El nombre de la métrica de salud en formato snake_case (p. ej., "step_count", "heart_rate", "active_energy")
  • units (String): La unidad de medida (p. ej., "count", "count/min", "kcal")
  • data (Array): Un array de puntos de datos, cada uno con:
    • qty (Number): El valor de cantidad
    • date (Date): Marca de tiempo en formato yyyy-MM-dd HH:mm:ss Z
    • source (String, cuando esté disponible): La app o el dispositivo que registró la muestra

Formatos especiales de métricas

Algunas métricas de salud tienen estructuras únicas que difieren del formato común:

Presión arterial

Las lecturas de presión arterial incluyen valores sistólicos y diastólicos:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

Campos:

  • systolic (Number): La lectura de presión arterial sistólica (superior). Las exportaciones resumidas usan el promedio de las lecturas del grupo temporal.
  • diastolic (Number): La lectura de presión arterial diastólica (inferior). Las exportaciones resumidas usan el promedio de las lecturas del grupo temporal.

Frecuencia cardiaca

Los datos de frecuencia cardiaca incluyen valores mínimo, medio y máximo:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

Campos:

  • Min (Number): Frecuencia cardiaca mínima durante el periodo de medición
  • Avg (Number): Frecuencia cardiaca media durante el periodo de medición
  • Max (Number): Frecuencia cardiaca máxima durante el periodo de medición

Variabilidad de la frecuencia cardiaca

Con Resumir datos desactivado, las exportaciones JSON de Variabilidad de la frecuencia cardiaca (SDNN) pueden incluir lecturas latido a latido disponibles. Requieren acceso de lectura a Serie de latidos en Apple Health.

Las exportaciones resumidas, las exportaciones CSV y el HRV de recuperación no incluyen lecturas latido a latido.

Análisis del sueño

La estructura de los datos de sueño depende de si Resumir datos está activado o desactivado.

Resumir datos activado

Con Resumir datos activado, los datos de sueño se resumen por día. Las duraciones de la misma fase se suman. El sueño total es la suma de asleep, core, deep y REM. JSON conserva cada día. En CSV, un grupo temporal más grueso muestra el último día de ese grupo:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

Campos:

  • totalSleep (Number): Tiempo total dormido en horas
  • asleep (Number): Tiempo dormido sin una fase de sueño registrada, en horas
  • core (Number): Duración del sueño core en horas
  • deep (Number): Duración del sueño profundo en horas
  • rem (Number): Duración del sueño REM en horas
  • awake (Number): Tiempo despierto en horas
  • sleepStart (Date): Cuándo empezó realmente el sueño
  • sleepEnd (Date): Cuándo terminó realmente el sueño
  • inBed (Number): Tiempo total en la cama en horas
  • inBedStart (Date): Cuándo te metiste en la cama
  • inBedEnd (Date): Cuándo te levantaste de la cama

Resumir datos desactivado

Con Resumir datos desactivado, se incluyen segmentos de sueño individuales:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

Campos:

  • date, start, startDate (Date): Hora de inicio del segmento de sueño
  • end, endDate (Date): Hora de fin del segmento de sueño
  • source (String): La app o el dispositivo que registró el segmento
  • qty (Number): Duración del segmento en horas
  • value (String): Estado del sueño - uno de:
    • "Awake"
    • "Asleep" (fase de sueño sin categorizar)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Nota: "Asleep" se refiere a una fase de sueño sin categorizar (no al tiempo total dormido). Puede ocurrir si el origen de datos no admite el seguimiento de fases del sueño.

Glucosa en sangre

Las lecturas de glucosa en sangre incluyen información sobre el momento de la comida:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

Campos:

  • qty (Number): Nivel de glucosa en sangre
  • mealTime (String): Uno de:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Nutrición

Cuando Resumir datos está desactivado, las muestras individuales de cantidad de nutrición (por ejemplo, Energía dietética o Carbohidratos) pueden incluir detalles de alimentos registrados en Apple Health. Por ejemplo:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

Campos:

  • qty (Number): Cantidad del nutriente de la muestra
  • foodType (String, opcional): Nombre del alimento registrado por la app de origen, cuando esté disponible

Con Resumir datos activado, los totales de nutrición no incluyen foodType.

Actividad sexual

Las entradas de actividad sexual registran el uso de protección:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

Campos:

  • Unspecified (Number): Recuento de eventos ese día cuando el estado de protección es desconocido
  • Protection Used (Number): Recuento de eventos ese día cuando se usó protección
  • Protection Not Used (Number): Recuento de eventos ese día cuando no se usó protección

Las exportaciones resumidas cuentan cada día del calendario. JSON conserva cada día. En CSV, un grupo temporal más grueso muestra el último día de ese grupo.

Lavado de manos

Los eventos de lavado de manos registran el estado de finalización:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

Campos:

  • qty (Number): Duración en segundos. Las exportaciones resumidas usan la duración media del grupo temporal.
  • value (String): "Completed" cuando la sesión dura más de 20 segundos; en caso contrario "Incomplete"

Cepillado de dientes

Los eventos de cepillado de dientes registran el estado de finalización:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

Campos:

  • qty (Number): Duración en segundos. Las exportaciones resumidas usan la duración media del grupo temporal.
  • value (String): "Completed" cuando la sesión dura al menos 2 minutos; en caso contrario "Incomplete"

Administración de insulina

Las entradas de administración de insulina incluyen el motivo de la administración:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

Campos:

  • qty (Number): Cantidad de insulina administrada. Las exportaciones resumidas suman las cantidades del grupo temporal.
  • reason (String): Uno de:
    • "Bolus" (insulina en las comidas)
    • "Basal" (insulina de fondo)

Documentación relacionada