ยา — รูปแบบการส่งออก JSON

เอกสารโครงสร้างข้อมูลยาในการส่งออก JSON

Last updated: April 5, 2026

ในหน้านี้

ยา

ข้อมูลยารวมยาทั้งหมดที่คุณเพิ่มใน 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): อาร์เรย์ของข้อมูลรหัสยาเพื่อระบุตามมาตรฐาน

รหัสยา (Medication Codings)

อาร์เรย์ 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": ไม่มีการโต้ตอบกับการเตือน

กรณีใช้งาน

ข้อมูลยาช่วยได้ใน:

  • การติดตามการปฏิบัติตาม: ดูว่ารับประทานสม่ำเสมอหรือไม่
  • เวชระเบียน: เก็บประวัติยาครบถ้วน
  • แชร์กับผู้ให้บริการ: ส่งรายการยาให้แพทย์
  • การวิเคราะห์ปฏิกิริยายา: เทียบกับข้อมูลสุขภาพอื่น
  • รายงานการปฏิบัติตาม: สร้างรายงานการรับประทานยา

เอกสารที่เกี่ยวข้อง