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 ao ciclo menstrual registradas no Apple Health, como fluxo menstrual, qualidade do muco cervical, temperatura corporal basal, resultados de testes de ovulação e outros dados relacionados ao 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 (veja os tipos abaixo)
  • value (String): O valor ou resultado para esta entrada (varia conforme 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

Registra 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

Registra a qualidade do muco cervical, que pode indicar o status 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

Registra 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

Registra 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

Registra 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

Registra 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

Registra 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

Registra 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

Registra 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 registram 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": ""
}

Sangramento Intermenstrual

Sangramento 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": ""
}

Sangramento Menstrual Persistente

Sangramento prolongado 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 Uso

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

  • Acompanhamento de fertilidade: Monitorar a ovulação e identificar janelas férteis
  • Análise do ciclo: Rastrear a duração, regularidade e padrões do ciclo
  • Monitoramento de saúde: Identificar irregularidades ou mudanças nos padrões do ciclo
  • Planejamento de gravidez: Usar dados para planejamento de concepção
  • Compartilhamento com profissionais de saúde: Compartilhar 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 ao ciclo podem aparecer em outras seçõ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

  • Registro consistente: O registro 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