약물 - JSON 내보내기 형식
JSON 내보내기에서 약물 구조에 대한 문서
최근 업데이트: 2026년 10월 31일
약물 내보내기에는 Health Auto Export가 읽도록 허용한 약물의 복용 이벤트가 포함됩니다. JSON의 medications 배열에 저장되며 iOS 26 이상이 필요합니다. 약물 접근을 참조하세요.
구조
{
"displayText": "Example medication",
"nickname": "Daily medication",
"start": "2024-02-06 08:05:00 -0800",
"end": "2024-02-06 08:05:00 -0800",
"scheduledDate": "2024-02-06 08:00:00 -0800",
"status": "Taken",
"isArchived": false,
"dosage": 1,
"scheduledDosage": 1,
"units": "count",
"codings": []
}
필드
displayText(문자열): 약물 표시 이름.nickname(문자열, 선택): 약물의 닉네임.start(문자열): 복용 이벤트 시작 시각.end(문자열, 선택): 사용 가능한 경우의 복용 이벤트 종료 시각. 이 날짜는 이벤트를 나타내며, 치료 과정의 시작이나 종료가 아닙니다.scheduledDate(문자열, 선택): 복용 예정 시각.status(문자열): 기록된 복용 상태. 아래를 참조하세요.isArchived(불리언): Apple Health에서 약물이 보관(아카이브)되었는지 여부.dosage(숫자, 선택): 기록된 복용량.scheduledDosage(숫자, 선택): 예정된 복용량.units(문자열): 복용량 단위.codings(배열): 기록 소스가 제공한 약물 식별자. 비어 있을 수 있습니다.
날짜는 yyyy-MM-dd HH:mm:ss Z를 사용합니다. 사용할 수 없는 선택 필드는 null로 설정되지 않고 생략됩니다.
상태 값
영어 상태 값은 Not Interacted, Notification Not Sent, Snoozed, Taken, Skipped, Not Logged, Unspecified입니다. 이는 기록된 이벤트 상태를 반영합니다.
약물 코딩
각 코딩에는 code, system, version 문자열이 포함됩니다. system은 코딩 시스템을 식별하며, 사용할 수 없을 때 version은 빈 문자열입니다.