HealthyApps Help Center

주기 추적 - JSON 내보내기 형식

JSON 내보내기에서 주기 추적 구조에 대한 문서

Last updated: February 6, 2026

On this page

주기 추적

주기 추적 데이터에는 Apple Health에 기록된 월경 주기 관련 정보가 모두 포함됩니다. 월경 흐름, 자궁경부 점액 품질, 기초 체온, 배란 테스트 결과 및 기타 주기 관련 데이터 등입니다. JSON 내보내기에서 주기 추적 데이터는 cycleTracking 배열에 저장됩니다.

구조

각 주기 추적 항목은 일관된 구조를 따릅니다:

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

필드

필수 필드

  • start (String): 항목의 시작 날짜 및 시간 (yyyy-MM-dd HH:mm:ss Z 형식)
  • end (String): 항목의 종료 날짜 및 시간 (yyyy-MM-dd HH:mm:ss Z 형식)
  • name (String): 주기 추적 데이터 유형 (아래 유형 참조)
  • value (String): 이 항목의 값 또는 결과 (유형에 따라 다름)

선택적 필드

  • isCycleStart (Boolean): 이 항목이 새로운 월경 주기의 시작을 표시하는지 여부. 월경 흐름 항목의 경우에만 값이 true일 때 존재합니다.

주기 추적 유형

월경 흐름

흐름 수준 및 주기 시작 정보와 함께 월경 출혈을 추적합니다.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

가능한 값:

  • "None" - 없음
  • "Light" - 가벼움
  • "Medium" - 보통
  • "Heavy" - 많음
  • "Unspecified" - 지정되지 않음

참고: isCycleStart는 값이 true일 때만 포함되며, 새로운 월경 주기의 시작을 나타냅니다.

자궁경부 점액 품질

생식 능력 상태를 나타낼 수 있는 자궁경부 점액의 품질을 추적합니다.

{
  "start": "2024-02-10 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Cervical Mucus Quality",
  "value": "Egg White"
}

가능한 값:

  • "Egg White" - 맑고 늘어나는 점액 (가장 임신 가능)
  • "Watery" - 얇고 수분이 많은 점액
  • "Creamy" - 두껍고 크림 같은 점액
  • "Sticky" - 끈적한 점액
  • "Dry" - 점액이 거의 없거나 없음

기초 체온

기초 체온(BBT) 측정값은 주기 추적 항목이 아닌 건강 지표로 내보내집니다. metrics 배열에서 "Basal Body Temperature"를 찾으세요.

배란 테스트 결과

배란 예측 테스트의 결과를 기록합니다.

{
  "start": "2024-02-12 08:00:00 -0800",
  "end": "2024-02-12 08:00:00 -0800",
  "name": "Ovulation Test Result",
  "value": "Positive/Peak"
}

가능한 값:

  • "Positive/Peak" - 최대 생식 능력 감지됨
  • "High" - 높은 생식 능력 수준
  • "Negative/Low" - 낮은 생식 능력 수준
  • "Indeterminate" - 테스트 결과 불명확

프로게스테론 테스트 결과

프로게스테론 테스트의 결과를 기록합니다.

{
  "start": "2024-02-15 08:00:00 -0800",
  "end": "2024-02-15 08:00:00 -0800",
  "name": "Progesterone Test Result",
  "value": "Positive"
}

임신 테스트 결과

임신 테스트의 결과를 기록합니다.

{
  "start": "2024-02-20 08:00:00 -0800",
  "end": "2024-02-20 08:00:00 -0800",
  "name": "Pregnancy Test Result",
  "value": "Positive"
}

성적 활동

주기 추적 맥락 내에서 성적 활동을 추적합니다.

{
  "start": "2024-02-14 20:00:00 -0800",
  "end": "2024-02-14 20:00:00 -0800",
  "name": "Sexual Activity",
  "value": ""
}

참고: 성적 활동은 피임 사용 세부 정보와 함께 건강 지표에도 나타날 수 있습니다.

임신

임신 기간을 추적합니다.

{
  "start": "2024-03-01 00:00:00 -0800",
  "end": "2024-11-15 23:59:59 -0800",
  "name": "Pregnancy",
  "value": ""
}

수유

수유 기간을 추적합니다.

{
  "start": "2024-11-20 00:00:00 -0800",
  "end": "2025-02-20 23:59:59 -0800",
  "name": "Lactation",
  "value": ""
}

피임

피임 사용 기간을 추적합니다.

{
  "start": "2024-01-01 00:00:00 -0800",
  "end": null,
  "name": "Contraceptive",
  "value": ""
}

주기 불규칙성

다음 유형은 다양한 주기 불규칙성을 추적합니다:

드문 월경 주기

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Infrequent Menstrual Cycle",
  "value": ""
}

불규칙한 월경 주기

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Irregular Menstrual Cycle",
  "value": ""
}

월경 간 출혈

월경과 월경 사이에 발생하는 출혈.

{
  "start": "2024-02-15 00:00:00 -0800",
  "end": "2024-02-15 23:59:59 -0800",
  "name": "Intermenstrual Bleeding",
  "value": ""
}

지속적인 월경 출혈

연장되거나 지속적인 출혈.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Persistent Menstrual Bleeding",
  "value": ""
}

연장된 월경 기간

평소보다 오래 지속되는 기간.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-08 23:59:59 -0800",
  "name": "Prolonged Menstrual Period",
  "value": ""
}

예제: 완전한 주기 항목

[
  {
    "start": "2024-02-01 00:00:00 -0800",
    "end": "2024-02-05 23:59:59 -0800",
    "name": "Menstrual Flow",
    "value": "Medium",
    "isCycleStart": true
  },
  {
    "start": "2024-02-10 00:00:00 -0800",
    "end": "2024-02-10 23:59:59 -0800",
    "name": "Cervical Mucus Quality",
    "value": "Egg White"
  },
  {
    "start": "2024-02-12 08:00:00 -0800",
    "end": "2024-02-12 08:00:00 -0800",
    "name": "Ovulation Test Result",
    "value": "Positive/Peak"
  },
  {
    "start": "2024-02-14 20:00:00 -0800",
    "end": "2024-02-14 20:00:00 -0800",
    "name": "Sexual Activity",
    "value": ""
  }
]

사용 사례

주기 추적 데이터는 다음에 유용할 수 있습니다:

  • 생식 능력 추적: 배란을 모니터링하고 임신 가능한 기간을 식별
  • 주기 분석: 주기 길이, 규칙성 및 패턴 추적
  • 건강 모니터링: 주기 패턴의 불규칙성이나 변화 식별
  • 임신 계획: 임신 계획을 위한 데이터 사용
  • 의료 제공자와 공유: 주기 데이터를 산부인과 의사나 생식 전문가와 공유
  • 증상 상관 관계: 주기 데이터를 다른 건강 지표와 교차 참조

관련 데이터

일부 주기 관련 데이터는 다른 섹션에 나타날 수 있습니다:

  • 기초 체온: 건강 지표로 metrics 배열에 있습니다
  • 성적 활동: 피임 사용 세부 정보와 함께 건강 지표에도 나타날 수 있습니다

팁

  • 일관된 기록: 정기적인 기록은 더 정확한 주기 예측을 제공합니다
  • 데이터 유형 결합: 여러 추적 방법(흐름, 점액, 온도, 테스트)을 사용하면 가장 포괄적인 그림을 제공합니다
  • 주기 시작 표시: 분석을 위해 각 주기의 시작을 식별하려면 isCycleStart를 사용하세요

관련 문서