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": 未与提醒交互

使用案例

药物数据可用于：

  • 依从性跟踪：监控药物服用的规律性
  • 医疗记录：维护完整的药物历史
  • 与医疗提供者共享：与医生共享药物列表
  • 药物相互作用分析：与其他健康数据进行交叉引用
  • 合规性报告：生成有关药物依从性的报告

相关文档