# 의료기관 연동

> 현재 지원되는 연동 패턴: 단일 호출로 검사 결과 전송, 기관을 대신하여 진료 기록 작성, 기기 연동, 동의 기반 제3자 앱 연동, 웹훅 및 SDK — 그리고 현재 지원되지 않는 기능.

Source: https://developers.anpheros.com/ko/guides/healthcare-integrations

**의료기관 연동은 건강 데이터를 생성하거나 필요한 시스템(검사실, 진료소, 기기, 다른 애플리케이션 등)을 환자의 기록과 연결합니다.** Anpheros에서는 모든 연동이 동일한 API와 동일한 규칙을 따릅니다. 데이터는 HL7 FHIR R4 형식으로 작성되며, 출처가 명시되고, 환자에게 공개되며, 환자의 동의 하에 다른 당사자와 공유됩니다. 이 페이지에서는 현재 플랫폼에서 지원하는 연동 패턴에 대해 설명합니다.

[Anpheros 연동 디렉토리 탐색](https://anpheros.com/integrations)을 통해 각 연동의 검증된 상태(사용 가능, 베타 또는 개발자 가이드), 교환되는 데이터 및 FHIR 리소스, 방향, 인증 및 문서를 확인할 수 있습니다.

## 검사실: 한 번의 호출로 전체 보고서 가져오기

검사실 또는 검사 보고서를 보유한 모든 시스템은 전체 보고서를 전송하며, 플랫폼은 모든 결과를 검사실 `Observation`로 변환합니다.

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv
```

- 형식: **CSV** (루마니아어 또는 영어 헤더, 소수점 쉼표 허용), **HL7 v2 ORU^R01** 및 **JSON**.
- 보고서에 코드가 제공되거나 이름이 플랫폼 용어와 일치하는 경우 마커는 **LOINC**로 매핑됩니다. 그렇지 않은 경우 검사실 자체 코드를 유지하며 `unmapped`으로 나열됩니다.
- 모든 행에는 고유 식별자가 할당되므로 **동일한 보고서를 다시 보내면 이미 가져온 항목은 건너뜁니다**.
- 요청당 최대 500개 행; 각 결과에는 소스 시스템 및 보고서 이름을 지정하는 출처 정보가 포함됩니다.

세부 정보: [검사실 커넥터](https://developers.anpheros.com/ko/guides/lab-connector).

## 클리닉: 조직을 대신하여 작성하기

클리닉과 그곳에서 일하는 사람들은 디렉토리 리소스입니다(`Organization`, `Practitioner`, `PractitionerRole`). 클리닉 시스템은 각 요청의 배후에 누가 있는지 말할 수 있습니다.

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — 귀하의 애플리케이션을 통해 작업하는 실무자; 액세스 로그에 기록되고 환자에게 이름으로 표시됩니다.
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — 쓰기가 수행되는 조직;
- `X-Anpheros-Author-Ref: Practitioner/<id>` — `Provenance`에 기록된 작성자.

환자의 동의 하에 클리닉은 다른 조직이 작성한 내용을 포함하여 전체 기록을 읽고 자신이 작성한 내용만 변경합니다. FHIR `transaction` 번들(`POST /fhir/R4`)을 사용하여 여러 리소스를 원자적으로 작성할 수 있습니다.

디렉토리에서 하나의 트랜잭션으로 작성된 방문까지의 작업 예시: [클리닉 시스템을 FHIR 백엔드와 통합하는 방법](https://developers.anpheros.com/ko/guides/integrate-clinic-systems-fhir).

동의 → 클리닉 프로젝트에서 작성한 랩 `Observation` → 환자의 앱에 알림 흐름은 테스트 클리닉 프로젝트로 엔드 투 엔드 실행되었습니다.

## 기기 및 웨어러블

기기에서 측정된 데이터는 `author_type: "device"`와 LOINC 코드를 포함하는 `Observation`입니다. 예를 들어 심박수, 혈압, SpO₂, 체중, 혈당, 걸음 수, 수면 시간 등이 있습니다 ([FHIR 코드 시스템](https://developers.anpheros.com/ko/guides/fhir-code-systems)). Anpheros Daily는 Apple Health 및 Health Connect에서 읽어온 일일 요약을 동일한 방식으로 Observation으로 작성합니다. Anpheros는 기기 공급업체의 클라우드에 직접 연결되지 않으며, 사용자의 애플리케이션 또는 백엔드에서 기기 데이터를 읽고 결과를 작성합니다. Apple Health, Health Connect 및 Samsung Health를 읽고 각 측정 항목을 LOINC에 매핑하는 방법은 [FHIR의 웨어러블 데이터](https://developers.anpheros.com/ko/guides/wearable-data-fhir)를 참조하십시오.

## 타사 애플리케이션: 동의 기반 액세스

Anpheros에 이미 저장된 개인 데이터를 원하는 애플리케이션은 한 번 등록하고 OAuth 2.1과 PKCE(SMART on FHIR 독립 실행형 시작)를 통해 동의를 요청합니다.

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — 호스팅된 동의 페이지;
2. 사용자는 기록과 기간(30, 90, 180 또는 365일)을 선택합니다.
3. `POST /oauth/token`은 코드를 액세스 토큰(30분) 및 순환 갱신 토큰(30일)으로 교환합니다.
4. 애플리케이션은 해당 환자만, 해당 범위 내에서, 자체 쌍별 ID로만 볼 수 있습니다.

[인증 및 OAuth](https://developers.anpheros.com/ko/guides/authentication)

## 이벤트: 변경 사항에 대한 반응

폴링 대신 웹훅을 등록하세요. 전달은 HMAC-SHA256으로 서명되며, 최대 24시간 동안 백오프를 사용하여 재시도됩니다. 전달에는 ID가 포함되며 임상 콘텐츠는 포함되지 않습니다. 다른 프로젝트가 액세스할 수 있는 레코드에 쓰는 경우, 이벤트가 이를 알립니다 (`data.external: true`, 출처 포함). [웹훅](https://developers.anpheros.com/ko/guides/webhooks)

## SDK

TypeScript (`@anpheros/sdk`) 및 Dart / Flutter (`anpheros_sdk`) SDK는 위에서 설명한 모든 기능 — 검사 결과 가져오기 (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), PKCE를 사용한 OAuth, 웹훅 관리 및 서명 검증 — 을 구현합니다. [SDK](https://developers.anpheros.com/ko/guides/sdks)

## 제공되지 않는 기능

- 특정 병원 EHR 또는 실험실 정보 시스템에 대한 즉시 사용 가능한 커넥터; 통합은 ⟦API⟧를 기반으로 구축됩니다.
- SMART EHR 시작 (EHR 내부에서 시작); 독립 실행형 시작만 지원됩니다.
- 직접적인 장치 공급업체 통합.

## 관련 자료

- [FHIR 백엔드와 클리닉 시스템 통합 방법](https://developers.anpheros.com/ko/guides/integrate-clinic-systems-fhir): 클리닉 EMR을 위한 단계별 튜토리얼
- [의료 데이터 정규화 방법](https://developers.anpheros.com/ko/guides/normalize-medical-data): 코드, 단위, 날짜, 중복, 유효성 검사
- [FHIR 레코드에 검사 결과 가져오기](https://developers.anpheros.com/ko/guides/import-lab-results-fhir): CSV 및 HL7 v2를 사용한 단계별 튜토리얼
- [의료 데이터 상호 운용성](https://developers.anpheros.com/ko/guides/interoperability)
- [Healthcare API](https://developers.anpheros.com/ko/guides/healthcare-api)
- [아키텍처](https://developers.anpheros.com/ko/guides/architecture)
- [사용 사례](https://developers.anpheros.com/ko/guides/use-cases)