Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

의료 통합

현재 지원되는 통합 패턴: 단일 호출 실험실 보고서, 조직을 대신하여 작성하는 클리닉, 장치, 동의된 타사 앱, 웹훅 및 SDK — 제공되지 않는 기능.

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

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

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

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

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개 행; 각 결과에는 소스 시스템 및 보고서 이름을 지정하는 출처 정보가 포함됩니다.

세부 정보: 검사실 커넥터.

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

클리닉과 그곳에서 일하는 사람들은 디렉토리 리소스입니다(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 백엔드와 통합하는 방법.

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

기기 및 웨어러블

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

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

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

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

인증 및 OAuth

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

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

SDK

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

제공되지 않는 기능

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