Medications - JSON Export Format

Documentation for medications structure in JSON exports

Last updated: February 6, 2026

On this page

약물

약물 데이터에는 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": []
}

상태 값 이해

status 필드는 약물 준수를 추적하는 데 도움이 됩니다:

"Taken": 약물이 성공적으로 복용됨
"Skipped": 약물이 의도적으로 건너뛰어짐
"Snoozed": 알림이 연기됨 (지연된 복용을 나타낼 수 있음)
"Not Logged": 작업이 기록되지 않음 (복용 누락을 나타낼 수 있음)
"Not Interacted": 알림과의 상호작용 없음

사용 사례

약물 데이터는 다음에 유용할 수 있습니다:

준수 추적: 약물이 얼마나 일관되게 복용되는지 모니터링
의료 기록: 포괄적인 약물 이력 유지
의료 제공자 공유: 약물 목록을 의사와 공유
약물 상호작용 분석: 다른 건강 데이터와 교차 참조
준수 보고: 약물 준수에 대한 보고서 생성

약물