# API трекера здоров'я

> Зберігайте кроки, пульс, ВСР, сон та SpO₂ з будь-якого ношеного пристрою як спостереження FHIR з кодами LOINC: які пристрої досягають певного сховища даних про здоров'я, чому немає веб-API та робочі запити.

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

**API трекера здоров'я дозволяє додатку надсилати та читати дані, які збирають годинники, кільця, браслети та ваги — кроки, пульс, варіабельність серцевого ритму, сон, насичення киснем, вага — як структуровані дані на сервері.** Більшість пристроїв не пропонують єдиного спільного API: їхні дані потрапляють до сховища даних про здоров'я телефону (Apple HealthKit або Android Health Connect), і ваш додаток читає їх звідти. Anpheros — це серверна частина: ваш додаток записує показники як спостереження FHIR R4 з кодами LOINC, а будь-який інший додаток, клініка або ШІ-агент за згодою особи читає ті самі дані через один API.

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

## Які пристрої досягають якого сховища даних про здоров'я

| Пристрій | Досягає | Читати за допомогою |
|---|---|---|
| Apple Watch, iPhone, багато програм для iOS | Apple HealthKit | Swift на iPhone ([Apple Health до FHIR](https://developers.anpheros.com/uk/guides/apple-health-fhir)) |
| Galaxy Watch, Wear OS, Fitbit, Garmin, Oura, Withings (програми для Android) | Android Health Connect | Kotlin або Flutter на телефоні ([Health Connect до FHIR](https://developers.anpheros.com/uk/guides/health-connect-fhir)) |
| Деталі Galaxy Watch, яких немає в Health Connect | Samsung Health | Samsung Health Data SDK ([Samsung Health до FHIR](https://developers.anpheros.com/uk/guides/samsung-health-fhir)) |

Ні HealthKit, ні Health Connect не мають веб- або REST API: дані зберігаються на телефоні, і їх може читати лише програма, яку встановила та дозволила особа. Тому API трекера здоров'я на сервері завжди починається з невеликої мобільної програми.

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

## Один день кроків

```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}"}
  }'
```

Зберігайте один Observation на метрику на локальний день, із зазначенням часового поясу особи в періоді. `Idempotency-Key` робить повторне надсилання безпечним. [Дані з носимих пристроїв у FHIR](https://developers.anpheros.com/uk/guides/wearable-data-fhir) містять повну таблицю LOINC та протестований щоденний upsert.

## Прочитати назад

```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"
```

Інший додаток читає ті самі дані лише за згодою особи (OAuth 2.1, SMART scopes, такі як `patient/Observation.rs?category=activity`), і кожне читання реєструється там, де особа може його побачити.

## Часті запитання

### Чи існує безкоштовний API для відстеження стану здоров'я?
Anpheros має безкоштовний пісочник (sandbox): зберігайте та читайте дані трекера як FHIR Observations з 30 синтетичними пацієнтами. Власні API виробників пристроїв (Fitbit, Garmin, Oura, Withings) мають власні правила доступу та умови.

### Чи існує веб-API для Apple Health або Health Connect?
Ні. HealthKit та Health Connect зберігають дані на телефоні; встановлений додаток читає їх за дозволом особи та може надсилати на сервер, такий як Anpheros.

### Які коди повинен використовувати API для відстеження стану здоров'я?
LOINC: 41950-7 кроки, 8867-4 пульс, 40443-4 пульс у спокої, 80404-7 варіабельність серцевого ритму (RMSSD), 59408-5 насичення киснем, 93832-4 тривалість сну, 29463-7 маса тіла. Одиниці вимірювання в UCUM.

### Чи підключається Anpheros безпосередньо до Fitbit або Garmin?
Ні. Їхні дані потрапляють до Anpheros через сховище даних телефону та ваш додаток; прямого з'єднання хмара-до-хмари немає.

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

## Пов'язане

- [API для носимих пристроїв: Fitbit, Garmin, Oura та Withings](https://developers.anpheros.com/uk/guides/wearable-apis)
- [Припинення роботи Fitbit Web API (жовтень 2026 року)](https://developers.anpheros.com/uk/guides/fitbit-web-api-shutdown)
- [Дані з носимих пристроїв у FHIR (Apple Health, Health Connect)](https://developers.anpheros.com/uk/guides/wearable-data-fhir)
- [Дистанційний моніторинг пацієнтів за допомогою FHIR](https://developers.anpheros.com/uk/guides/remote-patient-monitoring-fhir)
- [Додаток для персональної медичної картки (PHR) з FHIR](https://developers.anpheros.com/uk/guides/personal-health-record-app)
- [API медичних даних](https://developers.anpheros.com/uk/guides/medical-data-api)