Léky - formát exportu JSON

Dokumentace ke struktuře léků v exportech JSON.

Last updated: February 6, 2026

Na této stránce

Léky

Data o lécích zahrnují všechny léky, které jste přidali do Apple Health, včetně plánovaných léků, dávek, informací o dodržování a podrobností o lécích. V JSON exportech jsou léky uloženy v poli medications.

Dostupnost

Export léků je k dispozici na iOS 26.0 a novějších. Pokud používáte starší verzi iOS, tento datový typ nebude ve vašich exportech k dispozici.

Struktura

Každý záznam o léku obsahuje podrobné informace o léku, jeho plánu a dodržování:

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

Pole

Základní informace

  • displayText (String): Zobrazovaný název léku (např. „Aspirin“, „Lisinopril“)
  • nickname (String | undefined): Volitelná přezdívka, kterou jste léku přiřadili
  • form (String): Fyzická forma léku. Možné hodnoty:
    • "Capsule"
    • "Cream"
    • "Device"
    • "Drops"
    • "Foam"
    • "Gel"
    • "Inhaler"
    • "Injection"
    • "Liquid"
    • "Lotion"
    • "Ointment"
    • "Patch"
    • "Powder"
    • "Spray"
    • "Suppository"
    • "Tablet"
    • "Topical"
    • "Unknown"

Data

  • start (Date): Datum a čas zahájení užívání léku ve formátu yyyy-MM-dd HH:mm:ss Z
  • end (Date | undefined): Datum a čas ukončení užívání léku (null, pokud je stále aktivní)
  • scheduledDate (Date | undefined): Datum a čas plánovaného užití léku

Stav a dodržování

  • status (String): Aktuální stav záznamu o léku. Možné hodnoty:
    • "Not Interacted" – žádná interakce nebyla zaznamenána
    • "Notification Not Sent" – oznámení nebylo odesláno
    • "Snoozed" – připomínka léku byla odložena
    • "Taken" – lék byl užit
    • "Skipped" – lék byl vynechán
    • "Not Logged" – nebyla provedena žádná akce záznamu
    • "Unspecified" – stav není určen

Další informace

  • isArchived (Boolean): Zda byl lék archivován (již se aktivně nesleduje)
  • dosage (Number | undefined): Množství dávky (jednotky závisí na léku)
  • codings (Array): Pole informací o kódování léku pro standardizovanou identifikaci

Kódování léčiv

Pole codings obsahuje standardizované identifikátory léčiv:

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

Pole kódování:

  • code (String): Identifikátor kódu léku
  • system (String): Použitý kódovací systém (např. RxNorm, NDC)
  • version (String | undefined): Volitelná verze kódovacího systému

Příklady záznamů

Aktivní lék

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

Vysazený lék

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

Plánovaný záznam léku

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

Význam stavových hodnot

Pole status pomáhá sledovat dodržování léčby:

  • "Taken": lék byl úspěšně užit
  • "Skipped": lék byl úmyslně vynechán
  • "Snoozed": připomínka byla odložena (může znamenat opožděné užití)
  • "Not Logged": nebyla zaznamenána žádná akce (může znamenat vynechanou dávku)
  • "Not Interacted": žádná interakce s připomínkou

Případy použití

Data o lécích mohou být užitečná pro:

  • Sledování dodržování: sledování pravidelnosti užívání léků
  • Zdravotní dokumentaci: udržování kompletní historie léků
  • Sdílení s poskytovateli: sdílení seznamů léků s lékaři
  • Analýzu interakcí: porovnání s dalšími zdravotními daty
  • Hlášení o dodržování: generování zpráv o užívání léků

Související dokumentace