HealthyApps Help Center

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. 查看每種資料類型的文件 以了解結構

相關文件