Centro de ajuda HealthyApps
Português (Portugal)
Centro de ajuda
Site principal ↗

Pesquisar tópicos de ajuda

Sincronizar dados do Apple Health com API REST

Envie dados de saúde para um endpoint de API REST.

Última atualização: 31 de outubro de 2026

Nesta página
Abrir a automaçãoNome, estado e notificaçõesConfigurar o endpoint
Definições do tipo de dados Definições do tipo de dados Métricas de saúdeTreinos
Definições de exportação Definições de exportação Formato de exportaçãoVersão de exportaçãoIntervalo de datasResumir dados e agrupamento temporal
Pedidos em lote e cargas úteis grandesAgendar lembretesFrequência de sincronização e guardarCabeçalhos do pedidoExportar dados históricos ou omitidosResolução de problemas

Envie exportações de saúde para um endpoint que aceite pedidos HTTP POST.

Importante — limitações das automações: O dispositivo deve estar desbloqueado para ler dados de saúde, e o iOS não garante execuções em segundo plano na frequência que escolher. Reveja as limitações das automações antes de confiar em exportações automáticas.

Abrir a automação

Abra Exportar → Automatizado no iPhone, ou Automações na barra lateral do iPad. Selecione Nova Automação, ou abra uma existente para a editar.

Nome, estado e notificações

Introduza um nome que identifique esta automação. Ativado permite execuções automáticas; deixe desativado até estar pronto.

Escolha as notificações de execução que pretender:

  • Notificar ao atualizar a cache indica que os dados de exportação foram preparados.
  • Notificar ao executar indica um carregamento bem-sucedido no seu endpoint.

Permita as notificações quando solicitado. Estas notificações informam a atividade; não agendam uma execução.

Configurar o endpoint

  1. Escolha API REST como Tipo de automação.
  2. Introduza um URL acessível a partir do seu iPhone ou iPad, por exemplo https://api.example.com/health-data.
  3. Adicione qualquer autenticação necessária em Cabeçalhos HTTP. Por exemplo, use Authorization como chave e Bearer YOUR_TOKEN como valor.
  4. Escolha um Tempo limite do pedido adequado ao seu endpoint.

Cada cabeçalho precisa de uma chave e um valor. Para um servidor noutro dispositivo, use o endereço de rede acessível em vez de localhost.

Definições do tipo de dados

Selecione um Tipo de dados para esta automação: Métricas de saúde, Treinos, Sintomas, ECG, Notificações de frequência cardíaca, Estado de espírito, Acompanhamento do ciclo ou Medicamentos. Estado de espírito exige iOS 18 ou posterior; Medicamentos exige iOS 26 ou posterior e acesso separado a medicamentos.

Métricas de saúde

Escolha Métricas de saúde, abra Selecionar métricas de saúde e selecione as medições de que precisar.

Para limitar as leituras a aplicações ou dispositivos específicos, abra Origens preferidas, escolha uma métrica e selecione as suas origens. Todas permite todas as origens que não foram excluídas. Use Origens excluídas para ignorar uma origem nas métricas de saúde desta automação. As exclusões têm prioridade; uma origem não selecionada não é substituída quando a preferida não tem dados. Selecione Guardar para aplicar as opções de origem ou Cancelar para as descartar.

Treinos

Escolha Treinos para exportar registos de treino. Incluir dados de rota adiciona os pontos de rota disponíveis aos dados JSON do treino. Não cria ficheiros GPX independentes.

Para a Versão 2, ative Incluir métricas do treino para adicionar leituras como frequência cardíaca, energia ativa e passos. Escolha Minutos ou Segundos para o Agrupamento temporal das métricas do treino; os segundos produzem mais detalhe e exportações maiores. A Versão 1 inclui sempre métricas do treino.

Definições de exportação

Formato de exportação

  • JSON conserva dados estruturados para integrações e análise.
  • CSV cria ficheiros tabulares para folhas de cálculo.
  • Markdown cria cabeçalhos e tabelas legíveis para notas e ficheiros.

Versão de exportação

Escolha Versão 2 para a estrutura de dados atual. Use Versão 1 quando um fluxo existente depender do formato anterior.

Intervalo de datas

Seleção Dados incluídos
Predefinido O dia anterior e hoje até à hora da execução
Desde a última sincronização Desde a sincronização anterior até à hora da execução
Hoje Hoje até à hora da execução
Ontem O dia anterior completo
Últimos 7 dias Os sete dias completos anteriores

Resumir dados e agrupamento temporal

Para JSON + Métricas de saúde, ative Resumir dados para combinar leituras em grupos temporais, ou desative para leituras individuais quando disponíveis. O resumo depende da métrica—por exemplo, os passos são somados e as leituras de peso são mediadas. As exportações CSV de métricas de saúde usam dados resumidos.

Quando Agrupamento temporal estiver disponível, escolha quanto detalhe conservar. Os grupos por hora ou por dia produzem menos linhas do que os de minuto ou segundo. As opções disponíveis dependem do intervalo de datas e do formato. O agrupamento temporal de treinos é configurado separadamente em Treinos.

Pedidos em lote e cargas úteis grandes

Para API REST + JSON, ative Pedidos em lote para enviar os dados em vários pedidos. Use isto quando o endpoint rejeitar corpos grandes ou pedidos grandes atingirem o tempo limite. O serviço recetor deve tratar cada pedido separadamente.

O lote não está disponível para CSV nem Markdown. Reduz o tamanho de cada pedido, mas não a quantidade de dados de saúde que o dispositivo precisa de ler. Consulte Desempenho se a preparação estiver lenta.

Agendar lembretes

Se pretender um aviso para desbloquear e abrir a aplicação, ative Ativar lembretes. Escolha Por hora, Todos os dias ou Dias selecionados e configure o minuto, a hora e os dias conforme apropriado. Permita o acesso a notificações quando solicitado; se for negado, use Abrir as definições de notificações.

Um lembrete não executa a automação nem confirma uma sincronização bem-sucedida. Toque nele para abrir a automação, ou use Abrir e sincronizar na notificação para solicitar uma execução. A automação deve estar ativada; um lembrete pode aparecer mesmo após uma execução em segundo plano bem-sucedida. As alterações de lembrete são aplicadas ao guardar.

Frequência de sincronização e guardar

Escolha um número e Minutos, Horas, Dias ou Semanas em Frequência de sincronização—por exemplo, a cada 15 minutos. É uma cadência desejada em segundo plano, não um horário garantido.

O dispositivo deve estar desbloqueado quando os dados de saúde forem lidos. Ative a Atualização em Segundo Plano para o Health Auto Export e desative o Modo de Poupança de Energia para as execuções automáticas. O iOS pode atrasar as execuções se o dispositivo estiver inativo ou os recursos do sistema forem limitados.

Ative Ativado quando estiver pronto para execuções automáticas e selecione Atualizar para guardar a automação. Pode carregar imediatamente um intervalo de datas com os passos seguintes.

Cabeçalhos do pedido

A aplicação define Content-Type para o formato escolhido e inclui:

Cabeçalho Significado
automation-name Nome da automação
automation-id Identificador da automação
automation-aggregation Agrupamento temporal selecionado
automation-period Intervalo de datas selecionado
session-id Identificador do pedido

Exportar dados históricos ou omitidos

Use Carga manual ao configurar pela primeira vez a automação para exportar dados históricos, ou mais tarde para cobrir datas que a sincronização automática não alcançou. Também a pode usar para verificar a configuração.

  1. Abra a automação e selecione Carga manual em Exportar dados existentes.
  2. Defina as datas de Início e Fim e selecione Iniciar exportação.
  3. Verifique o pedido recebido no seu endpoint, os cabeçalhos e o corpo.

Resolução de problemas

  • Nenhum pedido recebido: Verifique o URL, a acessibilidade da rede e os registos do servidor.
  • Erro de autenticação: Verifique a chave do cabeçalho, o token e as permissões do endpoint.
  • Carga útil rejeitada ou tempo limite: Verifique os limites de tamanho do servidor, use lote para JSON ou reduza o tamanho da exportação.

Abra a automação e selecione Ver registos de atividade para rever uma execução. Os avisos assinalam possíveis problemas como uma recuperação de dados lenta; os erros identificam passos com falha. Para ajuda ao reportar um problema, consulte Obter ajuda.