Thuốc

Dữ liệu thuốc gồm tất cả thuốc bạn đã thêm vào Apple Health, bao gồm thuốc theo lịch, liều dùng, thông tin tuân thủ và chi tiết thuốc. Trong bản xuất JSON, thuốc nằm trong mảng medications.

Khả dụng

Xuất thuốc có trên iOS 26.0 trở lên. Nếu bạn dùng phiên bản iOS cũ hơn, loại dữ liệu này sẽ không có trong bản xuất.

Cấu trúc

Mỗi mục thuốc gồm thông tin đầy đủ về thuốc, lịch uống và tuân thủ:

{
  "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
    }
  ]
}

Trường

Thông tin cơ bản

• displayText (Chuỗi): Tên hiển thị của thuốc (ví dụ “Aspirin”, “Lisinopril”)
• nickname (Chuỗi | undefined): Biệt danh tùy chọn bạn đặt cho thuốc
• form (Chuỗi): Dạng bào chế. Các giá trị có thể có:
  • "Capsule"
  • "Cream"
  • "Device"
  • "Drops"
  • "Foam"
  • "Gel"
  • "Inhaler"
  • "Injection"
  • "Liquid"
  • "Lotion"
  • "Ointment"
  • "Patch"
  • "Powder"
  • "Spray"
  • "Suppository"
  • "Tablet"
  • "Topical"
  • "Unknown"

Ngày giờ

• start (Ngày giờ): Thời điểm bạn bắt đầu dùng thuốc, định dạng yyyy-MM-dd HH:mm:ss Z
• end (Ngày giờ | undefined): Thời điểm ngừng dùng thuốc (null nếu vẫn đang dùng)
• scheduledDate (Ngày giờ | undefined): Thời điểm theo lịch cần uống thuốc

Trạng thái và tuân thủ

• status (Chuỗi): Trạng thái hiện tại của mục thuốc. Các giá trị có thể có:
  • "Not Interacted" — Chưa ghi nhận tương tác
  • "Notification Not Sent" — Không gửi được thông báo
  • "Snoozed" — Đã hoãn nhắc thuốc
  • "Taken" — Đã uống thuốc
  • "Skipped" — Đã bỏ qua liều
  • "Not Logged" — Chưa ghi nhận hành động
  • "Unspecified" — Trạng thái không xác định

Thông tin bổ sung

• isArchived (Boolean): Thuốc đã lưu trữ (không còn theo dõi tích cực)
• dosage (Số | undefined): Số liều (đơn vị tùy loại thuốc)
• codings (Mảng): Mảng thông tin mã hóa để nhận diện chuẩn hóa

Mã hóa thuốc (codings)

Mảng codings chứa định danh thuốc chuẩn hóa:

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

Trường trong mã hóa:

• code (Chuỗi): Mã định danh thuốc
• system (Chuỗi): Hệ thống mã hóa (ví dụ RxNorm, NDC)
• version (Chuỗi | undefined): Phiên bản tùy chọn của hệ thống mã hóa

Ví dụ mục

Thuốc đang dùng

{
  "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
    }
  ]
}

Thuốc đã ngừng

{
  "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": []
}

Mục theo lịch, chưa ghi

{
  "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": []
}

Hiểu giá trị status

Trường status giúp theo dõi tuân thủ dùng thuốc:

• "Taken": Đã uống thuốc thành công
• "Skipped": Đã cố ý bỏ qua liều
• "Snoozed": Đã hoãn nhắc (có thể uống trễ)
• "Not Logged": Chưa ghi nhận hành động (có thể bỏ liều)
• "Not Interacted": Chưa tương tác với nhắc

Trường hợp dùng

Dữ liệu thuốc hữu ích cho:

• Theo dõi tuân thủ: Theo dõi mức độ uống thuốc đều đặn
• Hồ sơ y tế: Duy trì lịch sử thuốc đầy đủ
• Chia sẻ với nhà cung cấp dịch vụ: Gửi danh sách thuốc cho bác sĩ
• Phân tích tương tác thuốc: Đối chiếu với dữ liệu sức khỏe khác
• Báo cáo tuân thủ: Tạo báo cáo về việc uống thuốc theo chỉ định

Tài liệu liên quan

• Tổng quan định dạng xuất JSON
• Hướng dẫn xuất thủ công
• Tổng quan tự động hóa