Acompanhamento do Ciclo - Formato de Exportação JSON

Documentação sobre a estrutura de acompanhamento do ciclo em exportações JSON

Last updated: February 6, 2026

On this page

Acompanhamento do Ciclo

Os dados de acompanhamento do ciclo incluem todas as informações relacionadas com o ciclo menstrual registadas no Apple Health, como o fluxo menstrual, a qualidade do muco cervical, a temperatura corporal basal, os resultados de testes de ovulação e outros dados relacionados com o ciclo. Nas exportações JSON, os dados de acompanhamento do ciclo são armazenados no array cycleTracking.

Estrutura

Cada entrada de acompanhamento do ciclo segue uma estrutura consistente:

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

Campos

Campos Obrigatórios

  • start (String): Data e hora de início da entrada no formato yyyy-MM-dd HH:mm:ss Z
  • end (String): Data e hora de fim da entrada no formato yyyy-MM-dd HH:mm:ss Z
  • name (String): Tipo de dado de acompanhamento do ciclo (ver tipos abaixo)
  • value (String): O valor ou resultado para esta entrada (varia consoante o tipo)

Campos Opcionais

  • isCycleStart (Boolean): Indica se esta entrada marca o início de um novo ciclo menstrual. Presente apenas para entradas de Fluxo Menstrual quando é true.

Tipos de Acompanhamento do Ciclo

Fluxo Menstrual

Regista o sangramento menstrual com o nível de fluxo e informações de início do ciclo.

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

Valores Possíveis:

  • "None" - Nenhum
  • "Light" - Leve
  • "Medium" - Médio
  • "Heavy" - Intenso
  • "Unspecified" - Não especificado

Nota: isCycleStart é incluído apenas quando é true, indicando o início de um novo ciclo menstrual.

Qualidade do Muco Cervical

Regista a qualidade do muco cervical, que pode indicar o estado de fertilidade.

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

Valores Possíveis:

  • "Egg White" - Muco claro e elástico (mais fértil)
  • "Watery" - Muco fino e aquoso
  • "Creamy" - Muco espesso e cremoso
  • "Sticky" - Muco pegajoso
  • "Dry" - Pouco ou nenhum muco

Temperatura Corporal Basal

As medições de temperatura corporal basal (BBT) são exportadas como métricas de saúde, não como entradas de acompanhamento do ciclo. Procure por "Basal Body Temperature" no array metrics.

Resultado do Teste de Ovulação

Regista os resultados dos testes de predição de ovulação.

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

Valores Possíveis:

  • "Positive/Peak" - Fertilidade máxima detectada
  • "High" - Nível alto de fertilidade
  • "Negative/Low" - Nível baixo de fertilidade
  • "Indeterminate" - Resultado do teste incerto

Resultado do Teste de Progesterona

Regista os resultados dos testes de progesterona.

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

Resultado do Teste de Gravidez

Regista os resultados dos testes de gravidez.

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

Atividade Sexual

Regista a atividade sexual no contexto do acompanhamento do ciclo.

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

Nota: A atividade sexual também pode aparecer nas métricas de saúde com detalhes sobre o uso de proteção.

Gravidez

Regista os períodos de gravidez.

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

Lactação

Regista os períodos de lactação.

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

Contraceptivo

Regista os períodos de uso de contraceptivos.

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

Irregularidades do Ciclo

Os seguintes tipos registam várias irregularidades do ciclo:

Ciclo Menstrual Infrequente

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

Ciclo Menstrual Irregular

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

Hemorragia Intermenstrual

Hemorragia que ocorre entre os períodos.

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

Hemorragia Menstrual Persistente

Hemorragia prolongada ou persistente.

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

Período Menstrual Prolongado

Períodos que duram mais do que o habitual.

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

Exemplo: Entrada Completa do Ciclo

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

Casos de Utilização

Os dados de acompanhamento do ciclo podem ser úteis para:

  • Acompanhamento de fertilidade: Monitorizar a ovulação e identificar janelas férteis
  • Análise do ciclo: Rastrear a duração, regularidade e padrões do ciclo
  • Monitorização de saúde: Identificar irregularidades ou mudanças nos padrões do ciclo
  • Planeamento de gravidez: Usar dados para planeamento de conceção
  • Partilha com profissionais de saúde: Partilhar dados do ciclo com ginecologistas ou especialistas em fertilidade
  • Correlação de sintomas: Cruzar referências de dados do ciclo com outras métricas de saúde

Dados Relacionados

Alguns dados relacionados com o ciclo podem aparecer noutras secções:

  • Temperatura Corporal Basal: Encontrada no array metrics como uma métrica de saúde
  • Atividade Sexual: Também pode aparecer nas métricas de saúde com detalhes sobre o uso de proteção

Dicas

  • Registo consistente: O registo regular fornece previsões de ciclo mais precisas
  • Combinar tipos de dados: Usar vários métodos de acompanhamento (fluxo, muco, temperatura, testes) fornece a imagem mais completa
  • Marcadores de início do ciclo: Use isCycleStart para identificar o início de cada ciclo para análise

Documentação Relacionada