Medications - JSON Export Format

Documentation for medications structure in JSON exports

Last updated: February 6, 2026

On this page

Farmaci

I dati dei farmaci includono tutti i farmaci che hai aggiunto ad Apple Health, inclusi i farmaci programmati, i dosaggi, le informazioni sull'aderenza e i dettagli dei farmaci. Nelle esportazioni JSON, i farmaci sono memorizzati nell'array medications.

Disponibilità

L'esportazione dei farmaci è disponibile su iOS 26.0 e versioni successive. Se stai utilizzando una versione precedente di iOS, questo tipo di dati non sarà disponibile nelle tue esportazioni.

Struttura

Ogni voce di farmaco include informazioni complete sul farmaco, il suo programma e l'aderenza:

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

Campi

Informazioni di Base

  • displayText (String): Il nome visualizzato del farmaco (es. "Aspirin", "Lisinopril")
  • nickname (String | undefined): Soprannome opzionale che hai assegnato al farmaco
  • form (String): Forma fisica del farmaco. Valori possibili:
    • "Capsule"
    • "Cream"
    • "Device"
    • "Drops"
    • "Foam"
    • "Gel"
    • "Inhaler"
    • "Injection"
    • "Liquid"
    • "Lotion"
    • "Ointment"
    • "Patch"
    • "Powder"
    • "Spray"
    • "Suppository"
    • "Tablet"
    • "Topical"
    • "Unknown"

Date

  • start (Date): Data e ora in cui hai iniziato ad assumere questo farmaco nel formato yyyy-MM-dd HH:mm:ss Z
  • end (Date | undefined): Data e ora in cui hai smesso di assumere questo farmaco (null se ancora attivo)
  • scheduledDate (Date | undefined): Data e ora in cui il farmaco è programmato per essere assunto

Stato e Aderenza

  • status (String): Stato attuale della voce del farmaco. Valori possibili:
    • "Not Interacted" - Nessuna interazione registrata
    • "Notification Not Sent" - La notifica non è stata inviata
    • "Snoozed" - Il promemoria del farmaco è stato posticipato
    • "Taken" - Il farmaco è stato assunto
    • "Skipped" - Il farmaco è stato saltato
    • "Not Logged" - Nessuna azione di registrazione è stata eseguita
    • "Unspecified" - Lo stato non è specificato

Informazioni Aggiuntive

  • isArchived (Boolean): Se il farmaco è stato archiviato (non più tracciato attivamente)
  • dosage (Number | undefined): Quantità del dosaggio (le unità dipendono dal farmaco)
  • codings (Array): Array di informazioni di codifica del farmaco per l'identificazione standardizzata

Codifica dei Farmaci

L'array codings contiene identificatori standardizzati dei farmaci:

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

Campi di Codifica:

  • code (String): L'identificatore del codice del farmaco
  • system (String): Il sistema di codifica utilizzato (es. RxNorm, NDC)
  • version (String | undefined): Versione opzionale del sistema di codifica

Esempi di Voci

Farmaco Attivo

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

Farmaco Interrotto

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

Voce di Farmaco Programmata

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

Comprensione dei Valori di Stato

Il campo status aiuta a tracciare l'aderenza ai farmaci:

  • "Taken": Il farmaco è stato assunto con successo
  • "Skipped": Il farmaco è stato intenzionalmente saltato
  • "Snoozed": Il promemoria è stato posticipato (può indicare un'assunzione ritardata)
  • "Not Logged": Nessuna azione è stata registrata (può indicare una dose persa)
  • "Not Interacted": Nessuna interazione con il promemoria

Casi d'Uso

I dati dei farmaci possono essere utili per:

  • Tracciamento dell'aderenza: Monitorare quanto regolarmente vengono assunti i farmaci
  • Cartelle cliniche: Mantenere una storia completa dei farmaci
  • Condivisione con i fornitori di assistenza sanitaria: Condividere elenchi di farmaci con i medici
  • Analisi delle interazioni farmacologiche: Incrociare con altri dati sanitari
  • Report di conformità: Generare report sull'aderenza ai farmaci

Documentazione Correlata