# API de rastreamento de saúde

> Armazene passos, frequência cardíaca, VFC, sono e SpO₂ de qualquer dispositivo vestível como Observações FHIR codificadas em LOINC: quais dispositivos chegam a qual loja de saúde, por que não há API web e requisições funcionais.

Source: https://developers.anpheros.com/pt/guides/health-tracker-api

**Uma API de rastreamento de saúde permite que uma aplicação envie e leia os dados que relógios, anéis, pulseiras e balanças coletam — passos, frequência cardíaca, variabilidade da frequência cardíaca, sono, saturação de oxigênio, peso — como dados estruturados num servidor.** A maioria dos dispositivos não oferece uma API partilhada: os seus dados chegam à loja de saúde do telemóvel (Apple HealthKit ou Android Health Connect), e a sua aplicação lê-os a partir daí. Anpheros é o lado do servidor: a sua aplicação escreve as leituras como Observações FHIR R4 codificadas em LOINC, e qualquer outra aplicação, clínica ou agente de IA com o consentimento da pessoa lê os mesmos dados através de uma única API.

<!-- visual:tracker-flow -->

## Que dispositivos alcançam que repositório de saúde

| Dispositivo | Alcança | Ler com |
|---|---|---|
| Apple Watch, iPhone, muitas apps iOS | Apple HealthKit | Swift no iPhone ([Apple Health para FHIR](https://developers.anpheros.com/pt/guides/apple-health-fhir)) |
| Galaxy Watch, Wear OS, Fitbit, Garmin, Oura, Withings (apps Android) | Android Health Connect | Kotlin ou Flutter no telemóvel ([Health Connect para FHIR](https://developers.anpheros.com/pt/guides/health-connect-fhir)) |
| Detalhes do Galaxy Watch não presentes no Health Connect | Samsung Health | Samsung Health Data SDK ([Samsung Health para FHIR](https://developers.anpheros.com/pt/guides/samsung-health-fhir)) |

Nem o HealthKit nem o Health Connect possuem uma API web ou REST: os dados residem no telemóvel e apenas uma app instalada e autorizada pela pessoa pode lê-los. Uma API de rastreamento de saúde num servidor, portanto, começa sempre com uma pequena app móvel.

<!-- visual:tracker-codes -->

## Escrever um dia de passos

```bash
curl -X POST https://platform.anpheros.com/fhir/R4/Observation \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" \
  -H "Idempotency-Key: steps-$PID-2026-10-15" \
  -d '{
    "resourceType": "Observation",
    "status": "final",
    "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "activity"}]}],
    "code": {"coding": [{"system": "http://loinc.org", "code": "41950-7", "display": "Number of steps in 24 hour Measured"}]},
    "subject": {"reference": "Patient/'"$PID"'"},
    "effectivePeriod": {"start": "2026-10-15T00:00:00+03:00", "end": "2026-10-16T00:00:00+03:00"},
    "valueQuantity": {"value": 8412, "unit": "steps", "system": "http://unitsofmeasure.org", "code": "{steps}"}
  }'
```

Armazene uma Observação por métrica por dia local, com o fuso horário da pessoa no período. O `Idempotency-Key` torna o reenvio inofensivo. [Dados de wearables em FHIR](https://developers.anpheros.com/pt/guides/wearable-data-fhir) contém a tabela LOINC completa e um upsert diário testado.

## Releia

```bash
# the last 30 daily step counts
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|41950-7&_sort=-date&_count=30" \
  -H "Authorization: Bearer $KEY"
```

Outra aplicação lê os mesmos dados apenas com o consentimento da pessoa (OAuth 2.1, âmbito SMART como `patient/Observation.rs?category=activity`), e cada leitura é registada onde a pessoa a pode ver.

## Perguntas frequentes

### Existe uma API gratuita para rastreadores de saúde?
A Anpheros tem uma sandbox gratuita: armazene e leia dados de rastreadores como Observações FHIR com 30 pacientes sintéticos. As APIs próprias dos fabricantes de dispositivos (Fitbit, Garmin, Oura, Withings) têm as suas próprias regras de acesso e termos.

### Existe uma API web para Apple Health ou Health Connect?
Não. HealthKit e Health Connect mantêm os dados no telemóvel; uma aplicação instalada lê-os com a permissão da pessoa e pode enviá-los para um servidor como a Anpheros.

### Quais códigos deve usar uma API de rastreador de saúde?
LOINC: 41950-7 passos, 8867-4 frequência cardíaca, 40443-4 frequência cardíaca em repouso, 80404-7 variabilidade da frequência cardíaca (RMSSD), 59408-5 saturação de oxigénio, 93832-4 duração do sono, 29463-7 peso corporal. Unidades em UCUM.

### A Anpheros conecta-se diretamente ao Fitbit ou Garmin?
Não. Os seus dados chegam à Anpheros através da loja de saúde do telemóvel e da sua aplicação; não existe uma ligação direta de nuvem para nuvem.

<!-- visual:cta-tracker -->

## Relacionados

- [APIs de Dispositivos Vestíveis: Fitbit, Garmin, Oura e Withings](https://developers.anpheros.com/pt/guides/wearable-apis)
- [Encerramento da API Web da Fitbit (outubro de 2026)](https://developers.anpheros.com/pt/guides/fitbit-web-api-shutdown)
- [Dados de Dispositivos Vestíveis em FHIR (Apple Health, Health Connect)](https://developers.anpheros.com/pt/guides/wearable-data-fhir)
- [Monitorização remota de pacientes com FHIR](https://developers.anpheros.com/pt/guides/remote-patient-monitoring-fhir)
- [Aplicação de registo de saúde pessoal (PHR) com FHIR](https://developers.anpheros.com/pt/guides/personal-health-record-app)
- [API de dados médicos](https://developers.anpheros.com/pt/guides/medical-data-api)
