HealthyApps Help Center

Medications - JSON Export Format

Documentation for medications structure in JSON exports

Last updated: February 6, 2026

On this page

藥物

藥物資料包括您新增到 Apple Health 的所有藥物，包括排程藥物、劑量、依從性資訊和藥物詳細資訊。在 JSON 匯出中，藥物儲存在 medications 陣列中。

可用性

藥物匯出在 iOS 26.0 及更高版本上可用。如果您使用的是較舊的 iOS 版本，此資料類型將不會在您的匯出中可用。

結構

每個藥物項目包含有關藥物、其時間表和依從性的全面資訊：

{
  "displayText": "Aspirin",
  "nickname": "Daily Aspirin",
  "start": "2024-01-01 08:00:00 -0800",
  "end": null,
  "scheduledDate": "2024-02-06 08:00:00 -0800",
  "form": "Tablet",
  "status": "Taken",
  "isArchived": false,
  "dosage": 81,
  "codings": [
    {
      "code": "1191",
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "version": null
    }
  ]
}

欄位

基本資訊

  • displayText (String): 藥物的顯示名稱（例如："Aspirin"、"Lisinopril"）
  • nickname (String | undefined): 您為藥物分配的可選暱稱
  • form (String): 藥物的實體形式。可能的值：
    • "Capsule"
    • "Cream"
    • "Device"
    • "Drops"
    • "Foam"
    • "Gel"
    • "Inhaler"
    • "Injection"
    • "Liquid"
    • "Lotion"
    • "Ointment"
    • "Patch"
    • "Powder"
    • "Spray"
    • "Suppository"
    • "Tablet"
    • "Topical"
    • "Unknown"

日期

  • start (Date): 您開始服用此藥物的日期和時間，格式為 yyyy-MM-dd HH:mm:ss Z
  • end (Date | undefined): 您停止服用此藥物的日期和時間（如果仍處於活動狀態則為 null）
  • scheduledDate (Date | undefined): 計劃服用藥物的日期和時間

狀態和依從性

  • status (String): 藥物項目的目前狀態。可能的值：
    • "Not Interacted" - 未記錄互動
    • "Notification Not Sent" - 未傳送通知
    • "Snoozed" - 藥物提醒已延後
    • "Taken" - 已服用藥物
    • "Skipped" - 已跳過藥物
    • "Not Logged" - 未執行任何記錄操作
    • "Unspecified" - 狀態未指定

附加資訊

  • isArchived (Boolean): 藥物是否已封存（不再主動追蹤）
  • dosage (Number | undefined): 劑量（單位取決於藥物）
  • codings (Array): 用於標準化識別的藥物編碼資訊陣列

藥物編碼

codings 陣列包含標準化的藥物識別碼：

{
  "codings": [
    {
      "code": "1191",
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "version": null
    }
  ]
}

編碼欄位：

  • code (String): 藥物代碼識別碼
  • system (String): 使用的編碼系統（例如：RxNorm、NDC）
  • version (String | undefined): 編碼系統的可選版本

項目範例

活動藥物

{
  "displayText": "Lisinopril",
  "nickname": "Blood Pressure Med",
  "start": "2023-06-01 08:00:00 -0800",
  "end": null,
  "scheduledDate": "2024-02-06 08:00:00 -0800",
  "form": "Tablet",
  "status": "Taken",
  "isArchived": false,
  "dosage": 10,
  "codings": [
    {
      "code": "29046",
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "version": null
    }
  ]
}

已停用藥物

{
  "displayText": "Antibiotic",
  "nickname": null,
  "start": "2024-01-15 12:00:00 -0800",
  "end": "2024-01-22 12:00:00 -0800",
  "scheduledDate": "2024-01-22 12:00:00 -0800",
  "form": "Capsule",
  "status": "Taken",
  "isArchived": true,
  "dosage": 500,
  "codings": []
}

計劃藥物項目

{
  "displayText": "Multivitamin",
  "nickname": null,
  "start": "2024-01-01 07:00:00 -0800",
  "end": null,
  "scheduledDate": "2024-02-06 07:00:00 -0800",
  "form": "Tablet",
  "status": "Not Logged",
  "isArchived": false,
  "dosage": 1,
  "codings": []
}

理解狀態值

status 欄位有助於追蹤藥物依從性：

  • "Taken": 藥物已成功服用
  • "Skipped": 藥物被有意跳過
  • "Snoozed": 提醒已延後（可能表示延遲服用）
  • "Not Logged": 未記錄任何操作（可能表示漏服）
  • "Not Interacted": 未與提醒互動

使用案例

藥物資料可用於：

  • 依從性追蹤：監控藥物服用的規律性
  • 醫療記錄：維護完整的藥物歷史
  • 與醫療提供者共享：與醫生共享藥物清單
  • 藥物相互作用分析：與其他健康資料進行交叉引用
  • 合規性報告：產生有關藥物依從性的報告

相關文件