Ubat-ubatan — format eksport JSON

Dokumentasi untuk struktur ubat-ubatan dalam eksport JSON

Last updated: April 5, 2026

Pada halaman ini

Ubat-ubatan

Data ubat-ubatan merangkumi semua ubat yang anda tambahkan ke Apple Health, termasuk ubat berjadual, dos, maklumat pematuhan dan butiran ubat. Dalam eksport JSON, ubat-ubatan disimpan dalam tatasusunan medications.

Ketersediaan

Eksport ubat-ubatan tersedia pada iOS 26.0 dan ke atas. Jika anda menggunakan versi iOS lebih lama, jenis data ini tidak tersedia dalam eksport anda.

Struktur

Setiap entri ubat merangkumi maklumat lengkap tentang ubat, jadual dan pematuhan:

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

Medan

Maklumat asas

  • displayText (Rentetan): Nama paparan ubat (cth. "Aspirin", "Lisinopril")
  • nickname (Rentetan | tidak ditakrif): Nama samaran pilihan yang anda tetapkan untuk ubat
  • form (Rentetan): Bentuk fizikal ubat. Nilai mungkin:
    • "Capsule"
    • "Cream"
    • "Device"
    • "Drops"
    • "Foam"
    • "Gel"
    • "Inhaler"
    • "Injection"
    • "Liquid"
    • "Lotion"
    • "Ointment"
    • "Patch"
    • "Powder"
    • "Spray"
    • "Suppository"
    • "Tablet"
    • "Topical"
    • "Unknown"

Tarikh

  • start (Tarikh): Tarikh dan masa anda mula mengambil ubat ini dalam format yyyy-MM-dd HH:mm:ss Z
  • end (Tarikh | tidak ditakrif): Tarikh dan masa anda berhenti mengambil ubat ini (null jika masih aktif)
  • scheduledDate (Tarikh | tidak ditakrif): Tarikh dan masa ubat dijadualkan diambil

Status dan pematuhan

  • status (Rentetan): Status semasa entri ubat. Nilai mungkin:
    • "Not Interacted" — Tiada interaksi direkodkan
    • "Notification Not Sent" — Pemberitahuan tidak dihantar
    • "Snoozed" — Peringatan ubat ditangguhkan
    • "Taken" — Ubat diambil
    • "Skipped" — Ubat dilangkau
    • "Not Logged" — Tiada tindakan log
    • "Unspecified" — Status tidak ditentukan

Maklumat tambahan

  • isArchived (Boolean): Sama ada ubat telah diarkibkan (tidak lagi dijejak aktif)
  • dosage (Nombor | tidak ditakrif): Jumlah dos (unit bergantung pada ubat)
  • codings (Tatasusunan): Tatasusunan maklumat pengekodan ubat untuk pengenalan terpiawai

Pengekodan ubat

Tatasusunan codings mengandungi pengecam ubat terpiawai:

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

Medan pengekodan:

  • code (Rentetan): Pengecam kod ubat
  • system (Rentetan): Sistem pengekodan digunakan (cth. RxNorm, NDC)
  • version (Rentetan | tidak ditakrif): Versi pilihan sistem pengekodan

Contoh entri

Ubat aktif

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

Ubat dihentikan

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

Entri ubat berjadual

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

Memahami nilai status

Medan status membantu menjejak pematuhan ubat:

  • "Taken": Ubat berjaya diambil
  • "Skipped": Ubat sengaja dilangkau
  • "Snoozed": Peringatan ditangguhkan (mungkin menunjukkan pengambilan lewat)
  • "Not Logged": Tiada tindakan direkodkan (mungkin menunjukkan dos terlepas)
  • "Not Interacted": Tiada interaksi dengan peringatan

Kes penggunaan

Data ubat-ubatan berguna untuk:

  • Penjejakan pematuhan: Pantau sejauh mana ubat diambil secara konsisten
  • Rekod perubatan: Kekalkan sejarah ubat lengkap
  • Perkongsian penyedia penjagaan: Kongsi senarai ubat dengan doktor
  • Analisis interaksi ubat: Rujuk silang dengan data kesihatan lain
  • Pelaporan pematuhan: Jana laporan tentang pematuhan ubat

Dokumentasi berkaitan