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 读数等数据类型
开始使用
- 导出您的数据 使用手动导出或设置自动化
- 在配置导出时选择 JSON 格式
- 选择导出版本 2 以获得最新的数据结构(推荐)
- 查看每种数据类型的文档 以了解结构