# EHR API 및 의료 기록 API

> 앱이 FHIR을 통해 건강 기록을 읽고 쓰는 방법: 병원 EHR API 대 환자 제어 기록 API, 각 API의 범위, GDPR 및 EU 호스팅, HIPAA(BAA 및 요청 시 미국 지역).

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

**EHR API(전자 건강 기록 API, EMR API 또는 의료 기록 API라고도 함)는 소프트웨어가 인터넷을 통해 환자의 건강 기록(인구 통계, 진단, 약물, 알레르기, 결과, 문서)을 읽고 쓸 수 있도록 하는 것으로, 일반적으로 OAuth 뒤에 HL7 FHIR R4 리소스로 제공됩니다.** Epic 및 Oracle Health와 같은 병원 EHR 공급업체는 자체 기록에 FHIR API를 노출하며, 미국에서는 인증된 EHR이 이러한 API를 통해 환자에게 액세스를 제공해야 합니다. Anpheros는 다른 부분입니다. 환자 제어 의료 기록 API로, 모든 앱이 이를 기반으로 구축할 수 있으며, 클리닉, 실험실, 앱 및 장치가 사람당 하나의 FHIR R4 기록에 쓰고 액세스하려면 해당 사람의 동의가 필요합니다.

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

## 두 종류의 의료 기록 API

| | 병원 EHR API (예: Epic, Oracle Health) | 환자 통제 기록 API (Anpheros) |
|---|---|---|
| 기록의 소유자 | 단일 병원 또는 보건 시스템 | 한 사람의 모든 출처 기록 |
| 액세스 방법 | 공급업체와의 앱 등록, 종종 보건 시스템별 | 셀프 서비스 샌드박스 키; 데이터 처리 계약 후 프로덕션 |
| 승인 주체 | 보건 시스템, 환자 접근 앱의 경우 환자 | 환자 (OAuth 동의) 또는 생성한 환자에 대한 조직 |
| 데이터 작성 | 제한적, 공급업체에 따라 다름 | 자체 리소스 생성, 업데이트 및 삭제; 모든 작성에 대한 출처 기록 |
| 표준 | FHIR R4 (미국 내에서는 US Core) | FHIR R4 및 더 간단한 REST API |
| 최적의 용도 | 병원에서 기록한 내용 읽기 | 개인이 소지하는 기록 기반 제품 구축 |

이 API들은 함께 작동합니다. 앱은 API를 통해 병원 EHR을 읽고, 병원을 기록된 출처로 하여 Anpheros에 해당 개인의 자체 기록을 유지할 수 있습니다.

## Anpheros 레코드 API 범위

| 레코드 부분 | FHIR 리소스 | REST v1 |
|---|---|---|
| 인구 통계 | `Patient` | `/v1/patients` |
| 진단 | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| 약물 | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| 검사 결과 및 활력 징후 | `Observation` (LOINC) | `/v1/patients/{id}/observations`, lab import |
| 문서 | `DocumentReference` | `/v1/patients/{id}/documents` |
| 모든 것, 순서대로 | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| 공유 가능한 요약 | `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"
```

## 규정 준수 및 데이터 위치

- **GDPR 및 EU:** 데이터는 유럽 연합(Google Cloud `europe-west4`, 네덜란드)에 저장 및 처리됩니다. 모든 읽기 및 쓰기는 기록되며 환자에게 공개됩니다. 다른 애플리케이션의 액세스에는 환자의 동의가 필요합니다.
- **HIPAA:** Anpheros는 미국 클리닉의 비즈니스 파트너 역할을 합니다. 비즈니스 파트너 계약(BAA) 및 미국 데이터 지역은 프로덕션 고객의 요청 시 제공됩니다. BAA가 서명된 후 미국 환자 데이터에 대한 프로덕션이 시작됩니다. 그때까지 HIPAA에 해당하는 보호 건강 정보를 Anpheros에 저장하지 마십시오.

## 자주 묻는 질문

### EHR API란 무엇인가요?
전자 건강 기록을 읽고 쓰는 소프트웨어를 위한 인터페이스로, 일반적으로 HL7 FHIR R4 리소스(예: Patient, Condition, MedicationStatement, Observation)를 사용하며 OAuth 및 SMART on FHIR로 인증됩니다.

### EHR API와 EMR API의 차이점은 무엇인가요?
실제로는 두 용어가 상호 교환적으로 사용됩니다. EMR은 전통적으로 한 의료기관의 기록을 의미하며, EHR은 여러 제공자 간에 공유될 기록을 의미합니다. 오늘날 둘 다 일반적으로 FHIR API로 노출됩니다.

### Anpheros를 통해 병원의 EHR에 접근할 수 있나요?
아니요. Anpheros는 자체적으로 병원 EHR에 연결되지 않습니다. 사용자의 앱은 별도로 병원의 FHIR API를 읽고, 사용자가 허용한 정보를 Anpheros 기록에 저장할 수 있습니다.

### 개발자를 위한 무료 의료 기록 API가 있나요?
예. Anpheros 샌드박스는 FHIR R4 및 REST를 통해 30명의 합성 환자를 무료로 제공합니다. 프로덕션 환경은 월 €99부터 시작합니다.

### Anpheros는 HIPAA를 준수하나요?
Anpheros는 미국 클리닉을 위한 **비즈니스 파트너(Business Associate)** 역할을 합니다. 프로덕션 고객에게는 비즈니스 파트너 계약(BAA) 및 미국 데이터 지역이 요청 시 제공되며, 이는 서면 보안 프로그램(위험 분석, 정책, 감사 로그, 암호화, 백업) 위에 추가됩니다. 보호 대상 건강 정보를 저장하기 전에 문의하십시오. BAA가 서명된 후에 프로덕션이 시작됩니다. [보안, 개인 정보 보호 및 데이터 상주](https://developers.anpheros.com/ko/guides/security)를 참조하십시오.

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

## 관련 자료

- [Healthcare API](https://developers.anpheros.com/ko/guides/healthcare-api)
- [환자 의료 기록](https://developers.anpheros.com/ko/guides/patient-medical-record)
- [종단 환자 데이터 API](https://developers.anpheros.com/ko/guides/longitudinal-patient-data-api)
- [건강 앱을 위한 환자 동의 플랫폼](https://developers.anpheros.com/ko/guides/patient-consent-platform)
- [보안, 개인 정보 보호 및 데이터 상주](https://developers.anpheros.com/ko/guides/security)
- [FHIR 백엔드와 클리닉 시스템 통합 방법](https://developers.anpheros.com/ko/guides/integrate-clinic-systems-fhir)