# API EHR i API rekordów medycznych

> Jak aplikacje odczytują i zapisują rekordy medyczne przez FHIR: API EHR szpitala kontra API rekordów kontrolowanych przez pacjenta, co każde z nich obejmuje, RODO i hosting w UE, a także HIPAA (BAA i region USA na życzenie).

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

**API EHR (API elektronicznej dokumentacji medycznej, zwane również API EMR lub API rekordów medycznych) umożliwia oprogramowaniu odczytywanie i zapisywanie dokumentacji medycznej pacjenta — danych demograficznych, diagnoz, leków, alergii, wyników, dokumentów — przez Internet, zazwyczaj jako zasoby HL7 FHIR R4 za pośrednictwem OAuth.** Dostawcy EHR szpitalnych, tacy jak Epic i Oracle Health, udostępniają API FHIR do swoich własnych rekordów, a w USA certyfikowane EHR muszą oferować pacjentom dostęp za pośrednictwem takich API. Anpheros to coś innego: API rekordów medycznych kontrolowanych przez pacjenta, na którym może bazować każda aplikacja, gdzie kliniki, laboratoria, aplikacje i urządzenia zapisują dane do jednego rekordu FHIR R4 na osobę, a dostęp wymaga zgody tej osoby.

<!-- visual:ehr-stack -->

## Dwa rodzaje API rekordów medycznych

| | API szpitalnego systemu EHR (np. Epic, Oracle Health) | API rekordów kontrolowanych przez pacjenta (Anpheros) |
|---|---|---|
| Czyje rekordy | Jeden szpital lub system opieki zdrowotnej | Jedna osoba, ze wszystkich źródeł, które do niego zapisują |
| Jak uzyskać dostęp | Rejestracja aplikacji u dostawcy, często dla każdego systemu opieki zdrowotnej | Klucz do piaskownicy samoobsługowej; produkcja po umowie o przetwarzaniu danych |
| Kto autoryzuje | System opieki zdrowotnej oraz pacjent dla aplikacji z dostępem pacjenta | Pacjent (zgoda OAuth) lub Twoja organizacja dla pacjentów, których tworzy |
| Zapisywanie danych | Ograniczone, zależy od dostawcy | Tworzenie, aktualizowanie i usuwanie własnych zasobów; pochodzenie przy każdym zapisie |
| Standard | FHIR R4 (US Core w USA) | FHIR R4 plus prostsze API REST |
| Najlepsze dla | Odczytu tego, co zarejestrował szpital | Budowania produktu opartego na rekordzie, który ludzie noszą ze sobą |

Działają razem: aplikacja może odczytywać szpitalny system EHR za pośrednictwem jego API i przechowywać własny rekord osoby w Anpheros, ze szpitalem jako zarejestrowanym źródłem.

## Zakres API rekordów Anpheros

| Część rekordu | Zasób FHIR | REST v1 |
|---|---|---|
| Dane demograficzne | `Patient` | `/v1/patients` |
| Diagnozy | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| Leki | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| Wyniki i parametry życiowe | `Observation` (LOINC) | `/v1/patients/{id}/observations`, import wyników laboratoryjnych |
| Dokumenty | `DocumentReference` | `/v1/patients/{id}/documents` |
| Wszystko, w kolejności | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| Udostępniane podsumowanie | `Patient/$summary` (IPS) | — |

```bash
# one patient's active problems, as FHIR
curl "https://platform.anpheros.com/fhir/R4/Condition?patient=$PID&clinical-status=active" \
  -H "Authorization: Bearer $KEY"
```

## Zgodność i lokalizacja danych

- **RODO i UE:** dane są przechowywane i przetwarzane w Unii Europejskiej (Google Cloud `europe-west4`, Holandia); każdy odczyt i zapis jest rejestrowany i widoczny dla pacjenta; dostęp przez inne aplikacje wymaga zgody pacjenta.
- **HIPAA:** Anpheros działa jako Business Associate dla klinik w USA. Umowa o współpracy (BAA) i region danych w USA są dostępne na żądanie dla klientów produkcyjnych; produkcja dla danych pacjentów z USA rozpoczyna się po podpisaniu BAA. Do tego czasu nie należy przechowywać chronionych informacji o stanie zdrowia objętych HIPAA w Anpheros.

## Często zadawane pytania

### Czym jest API EHR?
Interfejs, za pomocą którego oprogramowanie odczytuje i zapisuje elektroniczną dokumentację medyczną, zazwyczaj zasoby HL7 FHIR R4, takie jak Patient, Condition, MedicationStatement i Observation, autoryzowane za pomocą OAuth i SMART on FHIR.

### Jaka jest różnica między API EHR a API EMR?
W praktyce terminy te są używane zamiennie. EMR tradycyjnie oznacza dokumentację jednej praktyki; EHR, dokumentację przeznaczoną do udostępniania między dostawcami. Oba są obecnie zazwyczaj udostępniane jako API FHIR.

### Czy mogę uzyskać dostęp do EHR szpitala za pośrednictwem Anpheros?
Nie. Anpheros nie łączy się samodzielnie z EHR szpitali. Twoja aplikacja może oddzielnie odczytywać API FHIR szpitala i przechowywać w swoim rekordzie Anpheros to, na co pozwoli użytkownik.

### Czy istnieje darmowe API rekordów medycznych dla deweloperów?
Tak. Sandbox Anpheros jest bezpłatny, z 30 syntetycznymi pacjentami w standardzie FHIR R4 i REST; produkcja zaczyna się od 49 EUR miesięcznie.

### Czy Anpheros jest zgodny z HIPAA?
Anpheros działa jako **Business Associate** dla klinik w USA: Umowa o współpracy w zakresie przetwarzania danych (BAA) i amerykański region danych są dostępne na żądanie dla klientów produkcyjnych, oprócz pisemnego programu bezpieczeństwa (analiza ryzyka, polityki, dziennik audytu, szyfrowanie, kopie zapasowe). Zapytaj przed przechowywaniem chronionych informacji o stanie zdrowia: produkcja rozpoczyna się po podpisaniu BAA. Zobacz [Bezpieczeństwo, prywatność i rezydencja danych](https://developers.anpheros.com/pl/guides/security).

<!-- visual:cta-ehr -->

## Powiązane tematy

- [API opieki zdrowotnej](https://developers.anpheros.com/pl/guides/healthcare-api)
- [Karta medyczna pacjenta](https://developers.anpheros.com/pl/guides/patient-medical-record)
- [API dla danych pacjenta w czasie](https://developers.anpheros.com/pl/guides/longitudinal-patient-data-api)
- [Platforma zgody pacjenta dla aplikacji zdrowotnych](https://developers.anpheros.com/pl/guides/patient-consent-platform)
- [Bezpieczeństwo, prywatność i rezydencja danych](https://developers.anpheros.com/pl/guides/security)
- [Jak zintegrować systemy kliniczne z backendem FHIR](https://developers.anpheros.com/pl/guides/integrate-clinic-systems-fhir)