# API EHR a API lekárskych záznamov

> Ako aplikácie čítajú a zapisujú zdravotné záznamy cez FHIR: API nemocničných EHR oproti API záznamov kontrolovaných pacientom, čo každé pokrýva, GDPR a EÚ hosting, a HIPAA (BAA a región USA na požiadanie).

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

**API EHR (API elektronického zdravotného záznamu, nazývané aj API EMR alebo API lekárskych záznamov) umožňuje softvéru čítať a zapisovať zdravotný záznam pacienta — demografické údaje, diagnózy, lieky, alergie, výsledky, dokumenty — cez internet, zvyčajne ako zdroje HL7 FHIR R4 cez OAuth.** Predajcovia EHR v nemocniciach, ako napríklad Epic a Oracle Health, sprístupňujú svoje vlastné záznamy prostredníctvom API FHIR a v USA musia certifikované EHR ponúkať prístup pacientom prostredníctvom takýchto API. Anpheros je iný prvok: API lekárskych záznamov kontrolovaných pacientom, na ktorom môže stavať akákoľvek aplikácia, kde kliniky, laboratóriá, aplikácie a zariadenia zapisujú do jedného záznamu FHIR R4 na osobu a prístup vyžaduje súhlas danej osoby.

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

## Dva druhy API pre zdravotné záznamy

| | API nemocničného EHR (napr. Epic, Oracle Health) | API záznamov ovládaných pacientom (Anpheros) |
|---|---|---|
| Čie záznamy | Jedna nemocnica alebo zdravotnícky systém | Jedna osoba, zo všetkých zdrojov, ktoré doň zapisujú |
| Ako získate prístup | Registrácia aplikácie u dodávateľa, často na zdravotnícky systém | Kľúč k sandboxu pre samoobsluhu; produkcia po dohode o spracovaní údajov |
| Kto autorizuje | Zdravotnícky systém a pacient pre aplikácie s prístupom pacienta | Pacient (súhlas OAuth) alebo vaša organizácia pre pacientov, ktorých vytvorí |
| Zapisovanie údajov | Obmedzené, závisí od dodávateľa | Vytváranie, aktualizácia a mazanie vlastných zdrojov; pôvod pri každom zápise |
| Štandard | FHIR R4 (v USA US Core) | FHIR R4 plus zjednodušené REST API |
| Najlepšie pre | Čítanie toho, čo zaznamenala nemocnica | Budovanie produktu na zázname, ktorý ľudia nosia so sebou |

Fungujú spolu: aplikácia môže čítať nemocničný EHR prostredníctvom jeho API a uchovávať vlastný záznam osoby v Anpheros, pričom nemocnica je zaznamenaným zdrojom.

## Čo pokrýva Anpheros records API

| Časť záznamu | FHIR resource | REST v1 |
|---|---|---|
| Demografické údaje | `Patient` | `/v1/patients` |
| Diagnózy | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| Lieky | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| Výsledky a vitálne funkcie | `Observation` (LOINC) | `/v1/patients/{id}/observations`, import laboratórnych výsledkov |
| Dokumenty | `DocumentReference` | `/v1/patients/{id}/documents` |
| Všetko, v poradí | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| Zdieľateľné zhrnutie | `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"
```

## Súlad s predpismi a umiestnenie údajov

- **GDPR a EÚ:** údaje sa ukladajú a spracúvajú v Európskej únii (Google Cloud `europe-west4`, Holandsko); každé čítanie a zápis je zaznamenané a viditeľné pre pacienta; prístup inými aplikáciami vyžaduje súhlas pacienta.
- **HIPAA:** Anpheros pôsobí ako Business Associate pre kliniky v USA. Dohoda o obchodnom partnerstve (BAA) a americký dátový región sú k dispozícii na požiadanie pre produkčných zákazníkov; produkcia pre údaje pacientov z USA sa otvorí po podpísaní BAA. Dovtedy neukladajte v Anpheros chránené zdravotné informácie, ktoré spadajú pod HIPAA.

## Často kladené otázky

### Čo je EHR API?
Rozhranie, prostredníctvom ktorého softvér číta a zapisuje elektronické zdravotné záznamy, zvyčajne zdroje HL7 FHIR R4 ako Patient, Condition, MedicationStatement a Observation, autorizované pomocou OAuth a SMART on FHIR.

### Aký je rozdiel medzi EHR API a EMR API?
V praxi sa tieto pojmy používajú zameniteľne. EMR tradične znamená záznam jednej ambulancie; EHR, záznam určený na zdieľanie medzi poskytovateľmi. Obe sú dnes zvyčajne vystavené ako FHIR API.

### Môžem prostredníctvom Anpheros získať prístup k EHR nemocnice?
Nie. Anpheros sa sám nepripája k nemocničným EHR. Vaša aplikácia môže samostatne čítať FHIR API nemocnice a ukladať to, čo osoba povolí, do svojho záznamu v Anpheros.

### Existuje bezplatné API pre lekárske záznamy pre vývojárov?
Áno. Sandbox Anpheros je bezplatný, s 30 syntetickými pacientmi cez FHIR R4 a REST; produkcia začína od 99 € mesačne.

### Je Anpheros v súlade s HIPAA?
Anpheros pôsobí ako **Business Associate** pre kliniky v USA: Business Associate Agreement (BAA) a americký dátový región sú k dispozícii na požiadanie pre produkčných zákazníkov, okrem písomného bezpečnostného programu (analýza rizík, politiky, auditný denník, šifrovanie, zálohy). Poraďte sa pred ukladaním chránených zdravotných informácií: produkcia sa otvorí po podpísaní BAA. Pozri [Bezpečnosť, súkromie a lokalita údajov](https://developers.anpheros.com/sk/guides/security).

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

## Súvisiace

- [Healthcare API](https://developers.anpheros.com/sk/guides/healthcare-api)
- [Zdravotný záznam pacienta](https://developers.anpheros.com/sk/guides/patient-medical-record)
- [API pre longitudinálne údaje pacienta](https://developers.anpheros.com/sk/guides/longitudinal-patient-data-api)
- [Platforma na správu súhlasu pacienta pre zdravotnícke aplikácie](https://developers.anpheros.com/sk/guides/patient-consent-platform)
- [Bezpečnosť, ochrana súkromia a lokalita údajov](https://developers.anpheros.com/sk/guides/security)
- [Ako integrovať klinické systémy s backendom FHIR](https://developers.anpheros.com/sk/guides/integrate-clinic-systems-fhir)