# API EHR e API per le cartelle cliniche

> Come le app leggono e scrivono cartelle cliniche tramite FHIR: API EHR ospedaliere vs API per cartelle cliniche controllate dal paziente, cosa copre ciascuna, GDPR e hosting UE, e HIPAA (BAA e regione USA su richiesta).

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

**Un'API EHR (API per cartelle cliniche elettroniche, chiamata anche API EMR o API per cartelle cliniche) consente al software di leggere e scrivere la cartella clinica di un paziente — dati demografici, diagnosi, farmaci, allergie, risultati, documenti — tramite Internet, solitamente come risorse HL7 FHIR R4 tramite OAuth.** I fornitori di EHR ospedalieri come Epic e Oracle Health espongono API FHIR alle proprie cartelle e, negli Stati Uniti, gli EHR certificati devono offrire l'accesso ai pazienti tramite tali API. Anpheros è un componente diverso: un'API per cartelle cliniche controllate dal paziente su cui qualsiasi app può basarsi, dove cliniche, laboratori, app e dispositivi scrivono in un'unica cartella FHIR R4 per persona e l'accesso richiede il consenso di tale persona.

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

## Due tipi di API per le cartelle cliniche

| | API EHR ospedaliero (es. Epic, Oracle Health) | API per cartelle controllate dal paziente (Anpheros) |
|---|---|---|
| Di chi sono le cartelle | Un ospedale o un sistema sanitario | Una persona, da ogni fonte che vi scrive |
| Come si ottiene l'accesso | Registrazione dell'app presso il fornitore, spesso per ogni sistema sanitario | Chiave sandbox self-service; produzione dopo un accordo di elaborazione dati |
| Chi autorizza | Il sistema sanitario e il paziente per le app di accesso al paziente | Il paziente (consenso OAuth) o la tua organizzazione per i pazienti che crea |
| Scrittura dei dati | Limitata, dipende dal fornitore | Creare, aggiornare ed eliminare le proprie risorse; provenienza su ogni scrittura |
| Standard | FHIR R4 (US Core negli Stati Uniti) | FHIR R4 più una API REST semplificata |
| Ideale per | Leggere ciò che un ospedale ha registrato | Costruire un prodotto su una cartella che le persone portano con sé |

Lavorano insieme: un'app può leggere un EHR ospedaliero tramite la sua API e mantenere la cartella personale della persona in Anpheros, con l'ospedale come fonte registrata.

## Cosa copre l'API dei record Anpheros

| Parte del record | Risorsa FHIR | REST v1 |
|---|---|---|
| Dati demografici | `Patient` | `/v1/patients` |
| Diagnosi | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| Farmaci | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| Risultati e parametri vitali | `Observation` (LOINC) | `/v1/patients/{id}/observations`, importazione laboratorio |
| Documenti | `DocumentReference` | `/v1/patients/{id}/documents` |
| Tutto, in ordine | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| Riepilogo condivisibile | `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"
```

## Conformità e localizzazione dei dati

- **GDPR e UE:** i dati vengono archiviati ed elaborati nell'Unione Europea (Google Cloud `europe-west4`, Paesi Bassi); ogni lettura e scrittura viene registrata e visibile al paziente; l'accesso da parte di altre applicazioni richiede il consenso del paziente.
- **HIPAA:** Anpheros agisce come Business Associate per le cliniche statunitensi. Un accordo di Business Associate (BAA) e una regione dati statunitense sono disponibili su richiesta per i clienti di produzione; la produzione per i dati dei pazienti statunitensi viene attivata dopo la firma del BAA. Fino ad allora, non archiviare informazioni sanitarie protette che rientrano nell'ambito dell'HIPAA in Anpheros.

## Domande frequenti

### Cos'è un'API EHR?
Un'interfaccia attraverso cui il software legge e scrive cartelle cliniche elettroniche, solitamente risorse HL7 FHIR R4 come Patient, Condition, MedicationStatement e Observation, autorizzate con OAuth e SMART on FHIR.

### Qual è la differenza tra un'API EHR e un'API EMR?
In pratica i termini sono usati in modo intercambiabile. EMR tradizionalmente significa la cartella di uno studio medico; EHR, una cartella destinata alla condivisione tra fornitori. Entrambe sono solitamente esposte come API FHIR oggi.

### Posso accedere all'EHR di un ospedale tramite Anpheros?
No. Anpheros non si connette autonomamente agli EHR ospedalieri. La tua app può leggere separatamente l'API FHIR di un ospedale e memorizzare ciò che la persona consente nel proprio record Anpheros.

### Esiste un'API gratuita per le cartelle mediche per sviluppatori?
Sì. La sandbox di Anpheros è gratuita, con 30 pazienti sintetici su FHIR R4 e REST; la produzione inizia da €99 al mese.

### Anpheros è conforme HIPAA?
Anpheros agisce come **Business Associate** per le cliniche statunitensi: un Business Associate Agreement (BAA) e una regione dati statunitense sono disponibili su richiesta per i clienti di produzione, oltre al programma di sicurezza scritto (analisi dei rischi, politiche, log di audit, crittografia, backup). Chiedi prima di memorizzare informazioni sanitarie protette: la produzione si apre dopo la firma del BAA. Vedi [Sicurezza, privacy e residenza dei dati](https://developers.anpheros.com/it/guides/security).

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

## Correlati

- [API Sanitaria](https://developers.anpheros.com/it/guides/healthcare-api)
- [Cartella clinica del paziente](https://developers.anpheros.com/it/guides/patient-medical-record)
- [API per dati longitudinali del paziente](https://developers.anpheros.com/it/guides/longitudinal-patient-data-api)
- [Piattaforma di consenso del paziente per app sanitarie](https://developers.anpheros.com/it/guides/patient-consent-platform)
- [Sicurezza, privacy e residenza dei dati](https://developers.anpheros.com/it/guides/security)
- [Come integrare sistemi clinici con un backend FHIR](https://developers.anpheros.com/it/guides/integrate-clinic-systems-fhir)