# API śledzenia stanu zdrowia

> Przechowuj kroki, tętno, HRV, sen i SpO₂ z dowolnego urządzenia noszonego jako Obserwacje FHIR zakodowane w LOINC: które urządzenia docierają do którego magazynu zdrowia, dlaczego nie ma internetowego API i przykładowe działające żądania.

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

**API śledzenia stanu zdrowia pozwala aplikacji na wysyłanie i odczytywanie danych zbieranych przez zegarki, pierścionki, opaski i wagi — kroki, tętno, zmienność tętna, sen, saturacja tlenem, waga — jako dane strukturalne na serwerze.** Większość urządzeń nie oferuje jednego wspólnego API: ich dane docierają do magazynu zdrowia telefonu (Apple HealthKit lub Android Health Connect), a Twoja aplikacja odczytuje je stamtąd. Anpheros to strona serwerowa: Twoja aplikacja zapisuje odczyty jako Obserwacje FHIR R4 zakodowane w LOINC, a każda inna aplikacja, klinika lub agent AI za zgodą osoby odczytuje te same dane za pośrednictwem jednego API.

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

## Które urządzenia docierają do których repozytoriów danych o stanie zdrowia

| Urządzenie | Dociera do | Odczyt za pomocą |
|---|---|---|
| Apple Watch, iPhone, wiele aplikacji na iOS | Apple HealthKit | Swift na iPhonie ([Apple Health do FHIR](https://developers.anpheros.com/pl/guides/apple-health-fhir)) |
| Galaxy Watch, Wear OS, Fitbit, Garmin, Oura, Withings (aplikacje na Androida) | Android Health Connect | Kotlin lub Flutter na telefonie ([Health Connect do FHIR](https://developers.anpheros.com/pl/guides/health-connect-fhir)) |
| Szczegóły Galaxy Watch nieobecne w Health Connect | Samsung Health | Samsung Health Data SDK ([Samsung Health do FHIR](https://developers.anpheros.com/pl/guides/samsung-health-fhir)) |

Ani HealthKit, ani Health Connect nie posiadają interfejsu API w postaci sieciowej lub REST: dane znajdują się na telefonie i mogą je odczytać tylko aplikacje zainstalowane i autoryzowane przez użytkownika. API śledzenia stanu zdrowia na serwerze zawsze zaczyna się więc od małej aplikacji mobilnej.

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

## Zapis jednego dnia kroków

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

Przechowuj jedną obserwację (Observation) dla każdej metryki na lokalny dzień, uwzględniając strefę czasową osoby w okresie. `Idempotency-Key` sprawia, że ponowne wysłanie jest nieszkodliwe. [Dane z urządzeń noszonych w FHIR](https://developers.anpheros.com/pl/guides/wearable-data-fhir) zawierają pełną tabelę LOINC i przetestowany codzienny upsert.

## Odczytaj ponownie

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

Inna aplikacja odczytuje te same dane tylko za zgodą osoby (OAuth 2.1, zakresy SMART, takie jak `patient/Observation.rs?category=activity`), a każdy odczyt jest rejestrowany w miejscu, w którym osoba może go zobaczyć.

## Często zadawane pytania

### Czy istnieje darmowe API do śledzenia stanu zdrowia?
Anpheros oferuje darmowe środowisko sandbox: przechowuj i odczytuj dane z urządzeń śledzących jako FHIR Observations dla 30 syntetycznych pacjentów. Własne API producentów urządzeń (Fitbit, Garmin, Oura, Withings) mają swoje własne zasady dostępu i warunki.

### Czy istnieje API internetowe dla Apple Health lub Health Connect?
Nie. HealthKit i Health Connect przechowują dane na telefonie; zainstalowana aplikacja odczytuje je za zgodą użytkownika i może wysyłać na serwer, taki jak Anpheros.

### Jakich kodów powinna używać API do śledzenia stanu zdrowia?
LOINC: 41950-7 kroki, 8867-4 tętno, 40443-4 spoczynkowe tętno, 80404-7 zmienność rytmu serca (RMSSD), 59408-5 nasycenie tlenem, 93832-4 czas trwania snu, 29463-7 masa ciała. Jednostki w UCUM.

### Czy Anpheros łączy się bezpośrednio z Fitbit lub Garmin?
Nie. Ich dane trafiają do Anpheros za pośrednictwem telefonu i Twojej aplikacji; nie ma bezpośredniego połączenia chmura-do-chmury.

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

## Powiązane

- [API urządzeń noszonych: Fitbit, Garmin, Oura i Withings](https://developers.anpheros.com/pl/guides/wearable-apis)
- [Zamknięcie Fitbit Web API (październik 2026)](https://developers.anpheros.com/pl/guides/fitbit-web-api-shutdown)
- [Dane z urządzeń noszonych w FHIR (Apple Health, Health Connect)](https://developers.anpheros.com/pl/guides/wearable-data-fhir)
- [Zdalne monitorowanie pacjentów z FHIR](https://developers.anpheros.com/pl/guides/remote-patient-monitoring-fhir)
- [Aplikacja Personal Health Record (PHR) z FHIR](https://developers.anpheros.com/pl/guides/personal-health-record-app)
- [API danych medycznych](https://developers.anpheros.com/pl/guides/medical-data-api)