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

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

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

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

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

## Какие устройства достигают какого хранилища данных о здоровье

| Устройство | Достигает | Читать с помощью |
|---|---|---|
| Apple Watch, iPhone, многие приложения для iOS | Apple HealthKit | Swift на iPhone ([Apple Health to FHIR](https://developers.anpheros.com/ru/guides/apple-health-fhir)) |
| Galaxy Watch, Wear OS, Fitbit, Garmin, Oura, Withings (приложения для Android) | Android Health Connect | Kotlin или Flutter на телефоне ([Health Connect to FHIR](https://developers.anpheros.com/ru/guides/health-connect-fhir)) |
| Детали Galaxy Watch, отсутствующие в Health Connect | Samsung Health | Samsung Health Data SDK ([Samsung Health to FHIR](https://developers.anpheros.com/ru/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 для каждой метрики за локальный день, указывая часовой пояс человека в поле `period`. `Idempotency-Key` позволяет избежать повторной отправки данных. [Данные с носимых устройств в FHIR](https://developers.anpheros.com/ru/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, такие как `patient/Observation.rs?category=activity`), и каждое считывание регистрируется, где человек может его увидеть.

## Часто задаваемые вопросы

### Существует ли бесплатный API для трекеров здоровья?
У Anpheros есть бесплатная песочница: храните и считывайте данные трекера как 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/ru/guides/wearable-apis)
- [Прекращение работы Fitbit Web API (октябрь 2026 г.)](https://developers.anpheros.com/ru/guides/fitbit-web-api-shutdown)
- [Данные носимых устройств в FHIR (Apple Health, Health Connect)](https://developers.anpheros.com/ru/guides/wearable-data-fhir)
- [Удаленный мониторинг пациентов с помощью FHIR](https://developers.anpheros.com/ru/guides/remote-patient-monitoring-fhir)
- [Приложение для записи личных медицинских данных (PHR) с использованием FHIR](https://developers.anpheros.com/ru/guides/personal-health-record-app)
- [API медицинских данных](https://developers.anpheros.com/ru/guides/medical-data-api)