Lääkitykset

Lääkitysdata sisältää kaikki Apple Healthiin lisäämäsi lääkkeet, mukaan lukien ajastetut lääkkeet, annokset, noudattamistiedot ja lääketiedot. JSON-vienneissä lääkitykset tallennetaan taulukkoon medications.

Saatavuus

Lääkitysten vienti on käytettävissä iOS 26.0 ja uudemmilla. Vanhemmalla iOS-versiolla tämä datatyyppi ei ole käytettävissä vienneissäsi.

Rakenne

Jokainen lääkitysmerkintä sisältää kattavat tiedot lääkkeestä, aikataulusta ja noudattamisesta:

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

Kentät

Perustiedot

• displayText (String): Lääkkeen näyttönimi (esim. "Aspirin", "Lisinopril")
• nickname (String | undefined): Valinnainen lempinimi lääkkeelle
• form (String): Lääkkeen fyysinen muoto. Mahdolliset arvot:
  • "Capsule"
  • "Cream"
  • "Device"
  • "Drops"
  • "Foam"
  • "Gel"
  • "Inhaler"
  • "Injection"
  • "Liquid"
  • "Lotion"
  • "Ointment"
  • "Patch"
  • "Powder"
  • "Spray"
  • "Suppository"
  • "Tablet"
  • "Topical"
  • "Unknown"

Päivämäärät

• start (Date): Aloitusaika lääkkeen ottamiselle muodossa yyyy-MM-dd HH:mm:ss Z
• end (Date | undefined): Lopetusaika (tai null, jos lääkitys on yhä käynnissä)
• scheduledDate (Date | undefined): Ajastettu ottamisaika

Tila ja noudattaminen

• status (String): Merkinnän tila. Mahdolliset arvot:
  • "Not Interacted" – Ei vuorovaikutusta
  • "Notification Not Sent" – Ilmoitusta ei lähetetty
  • "Snoozed" – Muistutus lykättiin
  • "Taken" – Lääke otettiin
  • "Skipped" – Lääke jätettiin väliin
  • "Not Logged" – Ei kirjattua toimintoa
  • "Unspecified" – Tila määrittämätön

Lisätiedot

• isArchived (Boolean): Onko lääkitys arkistoitu (ei enää aktiivista seurantaa)
• dosage (Number | undefined): Annoksen määrä (yksikkö riippuu lääkkeestä)
• codings (Array): Taulukko standardoituja lääketunnisteita varten

Lääkityksen koodaukset

codings-taulukko sisältää standardoidut lääketunnisteet:

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

Koodauskentät:

• code (String): Lääkekoodi
• system (String): Koodausjärjestelmä (esim. RxNorm, NDC)
• version (String | undefined): Valinnainen järjestelmäversio

Esimerkkimerkinnät

Aktiivinen lääkitys

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

Lopetettu lääkitys

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

Ajastettu lääkitysmerkintä

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

Tilojen ymmärtäminen

Kenttä status auttaa seuraamaan lääkityksen noudattamista:

• "Taken": Lääke otettiin onnistuneesti
• "Skipped": Lääke jätettiin tarkoituksella väliin
• "Snoozed": Muistutus lykättiin (voi viitata myöhempään ottamiseen)
• "Not Logged": Toimintaa ei kirjattu (voi viitata unohtuneeseen annokseen)
• "Not Interacted": Ei vuorovaikutusta muistutuksen kanssa

Käyttötapaukset

Lääkitysdata voi olla hyödyllistä:

• Noudattamisen seuranta: Seuraa, kuinka johdonmukaisesti lääkkeitä otetaan
• Potilaskertomukset: Pidä kattava lääkehistoria
• Jakaminen hoitajalle: Jaa lääkeluetteloita lääkäreille
• Lääkeinteraktioiden analyysi: Ristiinnaulaa muihin terveysdatoihin
• Noudattamisraportointi: Tuota raportteja lääkityksen noudattamisesta

Liittyvä dokumentaatio

• JSON-viennin muoto – yleiskatsaus
• Manuaalinen vienti
• Automaatiot – yleiskatsaus