Cikluskövetés – JSON exportformátum

A cikluskövetés szerkezetének dokumentációja JSON exportokban

Last updated: April 5, 2026

Ezen az oldalon

Cikluskövetés

A cikluskövetési adatok minden menstruációs ciklussal kapcsolatos információt tartalmaznak, amelyet az Apple Healthben rögzítettél – például menstruációs vérzés, méhnyaknyák minősége, bazális testhőmérséklet, ovulációs teszt eredmények és egyéb ciklushoz kapcsolódó adatok. JSON exportokban a cikluskövetési adatok a cycleTracking tömbben tárolódnak.

Szerkezet

Minden cikluskövetési bejegyzés következetes szerkezetet követ:

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

Mezők

Kötelező mezők

  • start (String): A bejegyzés kezdő dátuma és ideje yyyy-MM-dd HH:mm:ss Z formátumban
  • end (String): A bejegyzés záró dátuma és ideje yyyy-MM-dd HH:mm:ss Z formátumban
  • name (String): A cikluskövetési adat típusa (lásd típusok alább)
  • value (String): Az adott bejegyzés értéke vagy eredménye (típustól függően változik)

Opcionális mezők

  • isCycleStart (Boolean): Jelzi, hogy a bejegyzés egy új menstruációs ciklus kezdetét jelöli-e. Csak Menstrual Flow bejegyzéseknél van jelen, ha true.

Cikluskövetési típusok

Menstrual Flow

Menstruációs vérzés követése átfolyási szinttel és cikluskezdő információval.

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

Lehetséges értékek:

  • "None"
  • "Light"
  • "Medium"
  • "Heavy"
  • "Unspecified"

Megjegyzés: Az isCycleStart csak akkor szerepel, ha true, és egy új menstruációs ciklus kezdetét jelzi.

Cervical Mucus Quality

A méhnyaknyák minőségének követése, amely a termékenység állapotára utalhat.

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

Lehetséges értékek:

  • "Egg White" – Tiszta, nyúlós nyák (legtermékenyebb)
  • "Watery" – Híg, vizes nyák
  • "Creamy" – Sűrű, krémes nyák
  • "Sticky" – Ragacsos nyák
  • "Dry" – Kevés vagy nincs nyák

Basal Body Temperature

A bazális testhőmérséklet (BBT) mérések egészségügyi metrikaként kerülnek exportálásra, nem cikluskövetési bejegyzésként. Keresd a „Basal Body Temperature” elemet a metrics tömbben.

Ovulation Test Result

Ovulációs előrejelző tesztek eredményei.

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

Lehetséges értékek:

  • "Positive/Peak" – Csúcstermékenység észlelve
  • "High" – Magas termékenységi szint
  • "Negative/Low" – Alacsony termékenységi szint
  • "Indeterminate" – Nem egyértelmű teszteredmény

Progesterone Test Result

Progeszteron tesztek eredményei.

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

Pregnancy Test Result

Terhességi tesztek eredményei.

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

Sexual Activity

Szexuális aktivitás követése a cikluskövetés kontextusában.

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

Megjegyzés: A szexuális aktivitás megjelenhet egészségügyi metrikák között is védelemhasználati részletekkel.

Pregnancy

Terhességi időszakok követése.

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

Lactation

Szoptatási időszakok követése.

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

Contraceptive

Fogamzásgátló használat időszakainak követése.

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

Ciklus rendellenességek

Az alábbi típusok különféle ciklusrendellenességeket követnek:

Infrequent Menstrual Cycle

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

Irregular Menstrual Cycle

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

Intermenstrual Bleeding

Vérzés a ciklusok között.

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

Persistent Menstrual Bleeding

Hosszan tartó vagy tartós vérzés.

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

Prolonged Menstrual Period

A szokásosnál hosszabb menstruáció.

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

Példa: teljes ciklus bejegyzés

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

Felhasználási esetek

A cikluskövetési adatok hasznosak lehetnek:

  • Termékenység követése: Ovuláció és termékeny időszakok azonosítása
  • Ciklus elemzés: Ciklushossz, rendszeresség és minták követése
  • Egészségügyi monitorozás: Rendellenességek vagy változások felismerése a ciklusmintákban
  • Terhességtervezés: Adatok fogantatás tervezéséhez
  • Megosztás szolgáltatókkal: Ciklusadatok nőgyógyászokkal vagy termékenységi szakemberekkel
  • Tünetkorreláció: Ciklusadatok összevetése más egészségügyi metrikákkal

Kapcsolódó adatok

Egyes ciklushoz kapcsolódó adatok más szakaszokban is megjelenhetnek:

  • Basal Body Temperature: A metrics tömbben egészségügyi metrikaként
  • Sexual Activity: Megjelenhet egészségügyi metrikák között védelemhasználati részletekkel

Tippek

  • Következetes naplózás: Rendszeres rögzítés pontosabb cikluselőrejelzést ad
  • Több adattípus kombinálása: Több módszer (vérzés, nyák, hőmérséklet, tesztek) együtt adja a legteljesebb képet
  • Cikluskezdő jelölők: Használd az isCycleStart mezőt minden ciklus elejének azonosításához elemzéshez

Kapcsolódó dokumentáció