증상 - JSON 내보내기 형식

JSON 내보내기에서 증상 구조에 대한 문서

Last updated: February 6, 2026

On this page

증상

증상 데이터에는 Apple Health에 기록한 두통, 피로, 메스꺼움 및 기타 건강 증상과 같은 모든 증상이 포함됩니다. JSON 내보내기에서 증상은 symptoms 배열에 저장됩니다.

구조

각 증상 항목에는 발생 시기, 심각도 및 데이터 소스에 대한 정보가 포함됩니다:

{
  "start": "2024-02-06 10:00:00 -0800",
  "end": "2024-02-06 12:00:00 -0800",
  "name": "Headache",
  "severity": "Moderate",
  "userEntered": true,
  "source": "Health Auto Export"
}

필드

필수 필드

start (Date): 증상의 시작 시간 (yyyy-MM-dd HH:mm:ss Z 형식)
end (Date): 증상의 종료 시간 (yyyy-MM-dd HH:mm:ss Z 형식)
name (String): 증상 이름 (예: "Headache", "Fatigue", "Nausea", "Fever")
severity (String): 증상의 심각도 수준 (예: "Mild", "Moderate", "Severe")
userEntered (Boolean): 증상이 사용자에 의해 수동으로 입력되었는지 (true) 또는 자동으로 기록되었는지 (false)
source (String): 증상 데이터의 소스 (예: 앱 이름, 기기 이름 또는 "Health Auto Export")

증상 지속 시간

증상은 다음과 같이 기록할 수 있습니다:

시점: start와 end가 같을 때, 순간적인 증상을 나타냅니다
지속 시간 기반: start와 end가 다를 때, 증상이 일정 기간 지속되었음을 나타냅니다

항목 예시

단일 시점 증상

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:00 -0800",
  "name": "Dizziness",
  "severity": "Mild",
  "userEntered": true,
  "source": "Health Auto Export"
}

지속 시간 기반 증상

{
  "start": "2024-02-06 08:00:00 -0800",
  "end": "2024-02-06 18:00:00 -0800",
  "name": "Fatigue",
  "severity": "Moderate",
  "userEntered": true,
  "source": "Health Auto Export"
}

여러 증상

[
  {
    "start": "2024-02-06 09:00:00 -0800",
    "end": "2024-02-06 11:00:00 -0800",
    "name": "Headache",
    "severity": "Severe",
    "userEntered": true,
    "source": "Health Auto Export"
  },
  {
    "start": "2024-02-06 10:00:00 -0800",
    "end": "2024-02-06 10:00:00 -0800",
    "name": "Nausea",
    "severity": "Mild",
    "userEntered": true,
    "source": "Health Auto Export"
  }
]

일반적인 증상

Apple Health는 다음을 포함하되 이에 국한되지 않는 다양한 증상 추적을 지원합니다:

Headache
Fatigue
Nausea
Dizziness
Fever
Cough
Sore Throat
Runny Nose
Body Aches
Chills
Shortness of Breath
Chest Pain
Abdominal Pain
Joint Pain
Muscle Pain

심각도 수준

심각도 수준은 증상이 기록된 방식에 따라 다를 수 있지만, 일반적인 값은 다음과 같습니다:

Mild: 경미한 불편함, 일상 활동에 큰 영향을 주지 않음
Moderate: 눈에 띄는 불편함, 일부 일상 활동에 영향을 줄 수 있음
Severe: 상당한 불편함, 일상 활동에 크게 영향을 줌

데이터 소스

source 필드는 증상 데이터의 출처를 나타냅니다:

사용자 입력: userEntered가 true일 때, 증상이 수동으로 기록되었습니다
앱 기록: userEntered가 false일 때, 증상이 연결된 건강 앱에 의해 기록되었을 수 있습니다
기기 기록: 일부 기기나 앱은 특정 증상을 자동으로 감지하고 기록할 수 있습니다

사용 사례

증상 데이터는 다음에 유용할 수 있습니다:

건강 추적: 시간에 따른 증상 패턴 모니터링
의료 예약: 의료 제공자와 증상 이력 공유
상관 관계 분석: 증상과 기타 건강 지표 간의 관계 식별
질병 추적: 회복을 모니터링하기 위해 질병 중 증상 추적
만성 질환 관리: 만성 질환과 관련된 증상 모니터링

팁

일관성 유지: 더 나은 분석을 위해 일관된 명명 및 심각도 수준을 사용하세요
시간 기록: 정확한 시작 및 종료 시간은 패턴 식별에 도움이 됩니다
다른 데이터와 결합: 포괄적인 건강 인사이트를 위해 증상을 다른 건강 지표(예: 체온, 심박수)와 교차 참조하세요

증상

구조

필드