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
- Estrutura
- Campos
- Campos Obrigatórios
- Campos Opcionais
- Tipos de Acompanhamento do Ciclo
- Fluxo Menstrual
- Qualidade do Muco Cervical
- Temperatura Corporal Basal
- Resultado do Teste de Ovulação
- Resultado do Teste de Progesterona
- Resultado do Teste de Gravidez
- Atividade Sexual
- Gravidez
- Lactação
- Contraceptivo
- Irregularidades do Ciclo
- Exemplo: Entrada Completa do Ciclo
- Casos de Utilização
- Dados Relacionados
- Dicas
- Documentação Relacionada
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 formatoyyyy-MM-dd HH:mm:ss Zend(String): Data e hora de fim da entrada no formatoyyyy-MM-dd HH:mm:ss Zname(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
metricscomo 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
isCycleStartpara identificar o início de cada ciclo para análise
Documentação Relacionada
- Visão Geral do Formato de Exportação JSON
- Métricas de Saúde - Para dados de temperatura corporal basal
- Guia de Exportação Manual
- Visão Geral de Automações