JSON 导出格式

JSON 导出格式结构的完整文档

Last updated: February 6, 2026

On this page

JSON 导出格式概述

当您以 JSON 格式导出健康数据时,所有数据都会组织到一个具有结构化格式的单个文件中,这使得导入数据库、以编程方式分析或与其他应用程序集成变得容易。

文件结构

所有导出的数据都包含在一个 data 对象中,该对象包含每种支持的数据类型的数组:

{
  "data": {
    "metrics": [],
    "workouts": [],
    "stateOfMind": [],
    "medications": [],
    "symptoms": [],
    "cycleTracking": [],
    "ecg": [],
    "heartRateNotifications": []
  }
}

数据类型

JSON 导出格式支持以下数据类型:

健康指标 (metrics)

包含所有健康指标数据的数组,例如步数、心率、血压、睡眠等。每个指标都遵循一个通用结构,包括指标名称、单位和数据点数组。

了解更多: 健康指标文档

锻炼 (workouts)

包含所有锻炼会话的数组,包括活动类型、持续时间、距离、消耗的卡路里、心率数据和路线信息(如果可用)。

了解更多: 锻炼文档

心理状态 (stateOfMind)

包含您的情绪和心理状态条目的数组,包括效价评级、标签和关联。

了解更多: 心理状态文档

药物 (medications)

包含您的药物记录的数组,包括药物名称、剂量、预定时间和依从性信息。

了解更多: 药物文档

症状 (symptoms)

包含症状条目的数组,包括开始和结束时间、严重程度和来源信息。

了解更多: 症状文档

周期追踪 (cycleTracking)

包含月经周期数据的数组,包括流量、宫颈粘液质量、基础体温和排卵测试结果。

了解更多: 周期追踪文档

心电图 (ecg)

包含来自兼容设备的 electrocardiogram (ECG) 读数的数组,包括分类、心率测量和电压数据。

了解更多: 心电图文档

心率通知 (heartRateNotifications)

包含高心率和低心率通知事件的数组,包括阈值和事件期间的详细心率测量。

了解更多: 心率通知文档

日期格式

JSON 导出中的所有日期都使用以下格式:

  • 格式: yyyy-MM-dd HH:mm:ss Z
  • 示例: 2024-02-06 14:30:00 -0800

此格式包括:

  • 日期(年-月-日)
  • 时间(24 小时格式:时:分:秒)
  • 时区偏移

为什么使用 JSON 格式?

JSON 格式非常适合:

  • 数据库存储 - 易于导入到 PostgreSQL、MySQL 或 MongoDB 等数据库
  • 数据分析 - 与数据分析工具和编程语言兼容
  • 应用程序集成 - 易于在自定义应用程序中解析和使用
  • 详细数据 - 保留复杂嵌套结构,适用于睡眠阶段和 ECG 读数等数据类型

开始使用

  1. 导出您的数据 使用手动导出或设置自动化
  2. 在配置导出时选择 JSON 格式
  3. 选择导出版本 2 以获得最新的数据结构(推荐)
  4. 查看每种数据类型的文档 以了解结构

相关文档