Ліки — формат експорту 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): стандартизовані коди для ідентифікації

Кодування ліків

Масив 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": []
}

Значення статусу

  • "Taken": прийом підтверджено
  • "Skipped": навмисно пропущено
  • "Snoozed": нагадування відкладено (можливий пізніший прийом)
  • "Not Logged": дію не зафіксовано (можливий пропуск дози)
  • "Not Interacted": не було взаємодії з нагадуванням

Сценарії використання

  • Контроль дотримання режиму
  • Медична історія препаратів
  • Обмін списком з лікарем
  • Аналіз взаємодій (разом з іншими даними)
  • Звіти про прийом

Пов’язані матеріали