Como exportar os dados do Samsung Health para o meu próprio servidor?

Ative a sincronização do Samsung Health com o Conexão Saúde (Health Connect) e deixe o Life Dashboard para Android, um app de código aberto, enviar os dados em JSON para uma URL que você escolher. Cada sincronização envia os registros novos do Samsung Health e do Galaxy Watch para o seu banco de dados, fluxo do n8n ou script, e um backfill (o envio de todo o histórico de uma vez) envia tudo o que está no Conexão Saúde.

Galaxy WatchSamsung HealthConexão SaúdeApp Life DashboardSeu servidor

Por Owen Vogelaar, que mantém o Life Dashboard 5 min de leitura

Baixar o app para Android

Por que passa pelo Conexão Saúde

O Samsung Health não tem uma API na nuvem à qual você possa se conectar, e o SDK de dados da própria Samsung é aberto só para parceiros registrados. Mas o Samsung Health sincroniza com o Conexão Saúde no celular, nos dois sentidos. O Conexão Saúde também não tem API web, então um app no celular lê os dados e os manda adiante. Mais sobre isso em uma API web para o Conexão Saúde ou o Apple Health.

O que você precisa

  • Um celular Android com Android 9 ou mais recente, o Conexão Saúde e o Samsung Health. Pareie o seu Galaxy Watch com o Samsung Health para ter os dados dele.
  • O Life Dashboard para Android. Está no Google Play por € 4,99 uma única vez (US$ 4,99), sem assinatura: o jeito fácil, com atualizações automáticas, e a compra apoia o desenvolvimento. Os caminhos gratuitos instalam o mesmo app com a mesma chave de assinatura: o APK assinado no GitHub, o Obtainium, que mantém esse APK atualizado, e o F‑Droid, que o compila a partir do código-fonte.
  • Um servidor que aceite um POST com JSON por HTTPS, com limite de corpo de pelo menos 10 MB. HTTP sem criptografia na sua própria rede exige Permitir webhooks com HTTP sem criptografia em Mais > Avançado.

Envie o Samsung Health para um webhook

  1. No Samsung Health, vá em Configurações > Conexão Saúde, toque em Get started, escolha os dados e toque em Permitir. A leitura e a gravação são permitidas separadamente.
  2. No app Life Dashboard, na aba Saúde, toque em Adicionar destino (se ainda não houver nada configurado, Usar seu próprio servidor), informe a sua URL em URL do webhook e toque em Adicionar webhook.
  3. Em Segredo de assinatura HMAC (opcional), toque em Gerar e coloque o mesmo valor no seu servidor.
  4. Toque em Salvar no topo, abra de novo a linha do endereço na aba e toque em Enviar teste.
  5. Toque em Permitir e autorize os seus tipos de dados e a leitura em segundo plano. Ative os tipos que você quer em O que enviar.
  6. Não deixe o Android interromper as sincronizações: Configurações > Apps > Life Dashboard > Bateria, definido como Sem restrições, e adicione o Life Dashboard a Apps nunca em suspensão em Configurações > Bateria > Limites de uso em segundo plano.
  7. Toque em Sincronizar agora. Para dados mais antigos, toque em Enviar histórico em O que enviar e escolha até onde voltar, de 30 dias até Todo o histórico.
Um destino webhook no app para Android, com o segredo de assinatura HMAC e os cabeçalhos

O que você recebe

Da lista da Samsung do que ela sincroniza com o Conexão Saúde, estes são os tipos que o app repassa:

ÁreaTipos
AtividadePassos, sessões de exercício, calorias totais e distância dos exercícios, VO2 máx. dos exercícios
SonoSessões de sono com fases
Coração e sangueFrequência cardíaca, pressão arterial, glicose no sangue, saturação de oxigênio
CorpoPeso, gordura corporal, altura, taxa metabólica basal
AlimentaçãoNutrição

Cada requisição é um POST com um objeto JSON. Resumido, e sem o uuid e o source que todo registro traz:

{
  "timestamp": "2026-10-04T07:15:02.481Z",
  "app_version": "1.23.0",
  "source": "health_connect",
  "sequence": 1842,
  "daily_totals": [
    { "date": "2026-10-04", "steps": 1204, "distance_meters": 911.6 }
  ],
  "sleep": [
    {
      "session_end_time": "2026-10-04T06:30:00Z",
      "duration_seconds": 28800,
      "stages": [
        { "stage": "deep", "start_time": "2026-10-03T23:00:00Z",
          "end_time": "2026-10-04T01:00:00Z", "duration_seconds": 7200 }
      ]
    }
  ]
}

Grave os registros usando como chave o uuid, que continua o mesmo quando um registro é enviado de novo, e use daily_totals para passos, distância e calorias, para que uma caminhada contada pelo celular e pelo relógio conte uma vez só. A referência do payload documenta todos os campos.

O que a Samsung guarda para si

Fora da lista da Samsung em outubro de 2026: estresse, ECG, Energy Score, variabilidade da frequência cardíaca, temperatura da pele, frequência respiratória, frequência cardíaca em repouso e acompanhamento do ciclo. O que o Samsung Health compartilha pode mudar a qualquer versão, então confira no seu próprio celular, nas permissões de app do Conexão Saúde para o Samsung Health.

Uma sincronização contínua, não um arquivo avulso

Isto não é um CSV com tudo o que o Samsung Health já guardou. A primeira sincronização envia os últimos 7 dias, e cada sincronização depois dela envia o que é novo ou mudou, a cada 60 minutos por padrão ou em horários fixos. Um backfill vai até onde o Conexão Saúde tem dados. O seu receptor decide o formato: linhas no Postgres, um arquivo CSV ou qualquer outra coisa.

Se o seu histórico mais antigo do Samsung Health está no Conexão Saúde depende do Samsung Health, e a Samsung não diz. O guia dela só diz que, depois que você conecta os dois, os dados novos ou atualizados são compartilhados. Para ver o que o Conexão Saúde guarda, rode um backfill de Todo o histórico depois de Permitir acesso ao histórico: ele envia tudo o que o Conexão Saúde tem dos tipos que você ativou, então o dia mais antigo que chegar ao seu receptor mostra até onde os seus dados vão.

Receptores que funcionam: a stack Life Dashboard com Postgres e Grafana, um nó Webhook do n8n, o Node-RED ou um script curto. A referência do payload tem um receptor em Python e um em Node.js para servir de ponto de partida.

A aba Logs do app para Android, com uma linha por entrega

Limites

  • Os dados do relógio chegam ao Conexão Saúde depois de chegarem ao celular: quando o relógio reconecta, ou quando você abre a tela inicial do Samsung Health ou a puxa para baixo. A Samsung segura a frequência cardíaca contínua por um tempo para economizar bateria.
  • Dados de mais de 30 dias antes de você dar acesso ao app pela primeira vez precisam da permissão de histórico do Conexão Saúde, que a página do backfill pede com Permitir acesso ao histórico.

Life Dashboard para Android

Ative o Conexão Saúde no Samsung Health, instale o app e toque em Enviar teste com a sua URL.

Disponível no Google Play

€ 4,99 uma única vez no Google Play: o jeito fácil, com atualizações automáticas, e ainda apoia o desenvolvimento.

Ou de graça, o mesmo app com a mesma chave de assinatura: APK no GitHub · Obtainium · F‑Droid

Baixar o app para Android Referência do payload

O app de código aberto para Android que este guia usa. Sem conta e sem nuvem. Mais sobre o app.

Perguntas frequentes

Existe uma API do Samsung Health que eu possa chamar do meu servidor?

Não para os seus próprios dados. A Samsung não tem uma API na nuvem à qual você possa se conectar, e o SDK de dados dela é para parceiros registrados. O Conexão Saúde no celular é o caminho aberto.

Dá para obter um arquivo CSV?

Sim. Mais > Exportar dados, na aba Saúde, compartilha o que a próxima sincronização enviaria como CSV ou JSON. Para o seu servidor, os dados de saúde saem do app em JSON, e o seu receptor também pode gravar CSV se você quiser.

Posso enviar também para o Home Assistant?

Sim. Pareie a integração Life Dashboard, como em Samsung Health no Home Assistant, e cada payload vai para os dois. Ele conta como entregue assim que um deles o aceita, então um destino que está fora do ar naquele momento fica sem ele.