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

의료 API: 정의 및 작동 방식

Q: 데이터는 어디에 저장되나요?

유럽 연합 내에 저장됩니다. 서비스 및 데이터베이스는 Google Cloud europe-west4 (네덜란드)에서 실행됩니다.

의료 API란 무엇이며, API 호출은 어떻게 작동하고, 무엇을 찾아야 하는지, 환자 동의, 출처 및 EU 호스팅을 갖춘 무료 FHIR R4 의료 API — 예제 및 FAQ 포함.

헬스케어 API는 소프트웨어가 환자 기록, 관찰 결과, 진단, 처방약, 문서 등 건강 데이터를 읽고 쓰는 프로그래밍 인터페이스이며, 해당 데이터에 대한 접근 권한을 부여하는 인터페이스입니다. Anpheros Platform API는 환자 통제 HL7 FHIR R4 레코드 기반의 헬스케어 API입니다. 애플리케이션은 이를 사용하여 의료 데이터를 저장 및 검색하고, 환자의 동의를 얻고, 변경 사항에 대한 알림을 받을 수 있습니다.

헬스케어 API 호출 방식

어떤 공급업체든 헬스케어 API 호출은 동일한 검증 단계를 거칩니다. 누가 호출하는지, 어떤 환자의 어떤 데이터에 접근할 수 있는지, 데이터가 어디에 저장되어 있는지, 누가 데이터를 작성했는지, 그리고 변경 사항을 누가 알아야 하는지 등입니다.

What happens in one healthcare API call

Your appSends a request with an API key or a patient's OAuth token
AuthorisationKey → your project's patients; token → one patient, granted scopes only
FHIR recordRead or write a coded resource; every version kept
Provenance + auditWho wrote it, for which organisation; the read is logged
EventsA signed webhook tells your other systems what changed

헬스케어 API의 종류

종류	교환 내용	일반적인 용도
FHIR REST API	HTTP를 통한 FHIR 리소스 (`GET /Observation?patient=…`)	임상 데이터 교환을 위한 최신 표준
SMART on FHIR / OAuth	FHIR API에 대한 인증	사용자의 허가를 받아 타사 앱이 기록에 접근하도록 허용
HL7 v2 메시징	파이프 구분 메시지 (결과 `ORU^R01`, 입원 `ADT`)	실험실 및 병원 시스템, 종종 HTTP 대신 인터페이스를 통해
문서 교환	임상 문서 (PDF, CDA, FHIR 문서 번들)	요약, 퇴원 서신, 의뢰
독점 REST API	공급업체별 JSON	단일 제품의 자체 모바일 앱 또는 통합

Anpheros는 첫 번째 두 가지를 핵심으로 결합하고, HL7 v2 실험실 결과를 입력으로 받아들이며, 원본과 함께 문서를 저장하고 FHIR 문서 번들(국제 환자 요약)을 생성합니다. 또한 FHIR을 직접 다루고 싶지 않은 개발자를 위해 동일한 데이터에 대한 더 간단한 REST API를 제공합니다.

헬스케어 API에서 확인해야 할 사항

What to look for in a healthcare API — and how Anpheros answers

Standard data modelHL7 FHIR R4 with LOINC, ICD-10, ATC, UCUM

Patient-controlled accessOAuth 2.1 consent with scopes, expiry and revocation

ProvenanceAuthor, organisation and source on every write

HistoryEvery version kept; conditional updates with If-Match

Audit of readsEach read and write logged, visible to the patient

Safe retriesIdempotency-Key on POST; predictable errors

IsolationPairwise patient ids per application

Data residencyEuropean Union: Google Cloud europe-west4

이 페이지의 나머지 부분에서는 이러한 각 항목이 Anpheros API에 어떻게 나타나는지 보여줍니다.

Anpheros API 개요

표면	기본 경로	목적
FHIR R4	`/fhir/R4`	26가지 리소스 타입; 읽기, 검색, 생성, 업데이트, 삭제, 기록, 트랜잭션, `$everything`, `$summary`, `$validate`
REST v1	`/v1`	환자, 관찰, 상태, 약물, 문서, 타임라인, 출처, AI 컨텍스트, 검사 결과 가져오기, 용어, 웹훅
OAuth 2.1	`/oauth`	동의 페이지, 토큰 (PKCE), 취소, OpenID Connect 키
환자 측	`/me`	개인의 기록, 접근 권한자, 접근 로그, 취소
검색	`/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json`	API의 기계 판독 가능한 설명

기본 URL: https://platform.anpheros.com. 샌드박스와 프로덕션 환경이 공유하며, 키가 데이터 플레인을 결정합니다.

인증

API 키 (sk_test_…, sk_live_…): 서버용; 프로젝트에서 생성한 환자에게 접근 가능합니다.
OAuth 액세스 토큰 (at_…): 동의 하에 한 명의 환자를 대신하여 작동하는 애플리케이션용입니다.

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

안전한 작성

POST 요청은 Idempotency-Key을 허용합니다. 동일한 키로 재시도된 요청은 원본 응답을 반환하며 아무것도 생성하지 않습니다. 모든 쓰기 작업에는 Provenance가 부여되며, 작성자 타입은 본문(author_type) 또는 X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id, X-Anpheros-On-Behalf-Of와 같은 헤더에 포함되어 전송됩니다.

curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

오류 및 제한

FHIR 엔드포인트는 OperationOutcome로 응답하며, 다른 엔드포인트는 {"error": {"type", "message", "field"}}로 응답합니다. 모든 응답에는 Anpheros-Request-Id이 포함됩니다. 기본 제한은 키당, IP당 분당 600개 요청입니다. 오류 · 제한

이벤트

resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized, ping에 대한 서명된 웹훅. 웹훅

FHIR과 REST v1 중 선택하기

FHIR은 이미 FHIR을 사용하고 있거나, /v1에서 다루지 않는 리소스 타입(예: Immunization, Procedure 또는 CarePlan)이 필요하거나, 다른 FHIR 시스템과 데이터를 교환해야 할 때 사용합니다. REST v1은 일반적인 경우에 플랫 JSON을 원하는 애플리케이션 코드에 사용합니다. 두 API 모두 동일한 ID로 동일한 리소스를 읽고 쓰므로, 프로젝트에서 혼합하여 사용할 수 있습니다. Medical data API에서 데이터 작업을 자세히 설명합니다.

자주 묻는 질문

헬스케어 API란 무엇인가요?

소프트웨어가 환자 기록, 관찰 결과, 진단, 약물 및 문서와 같은 건강 데이터를 읽고 쓰는 프로그래밍 인터페이스이며, 해당 데이터에 대한 접근 권한을 부여합니다. 최신 헬스케어 API는 데이터에 HL7 FHIR R4를 사용하고, 권한 부여에는 OAuth 2.0 또는 2.1과 SMART on FHIR을 사용합니다.

헬스케어 API와 FHIR API의 차이점은 무엇인가요?

FHIR은 헬스케어 API가 따를 수 있는 표준 중 하나입니다. FHIR API는 REST를 통해 FHIR 리소스를 교환하며, 헬스케어 API는 HL7 v2 메시지, 문서 또는 독점 JSON도 수락할 수 있습니다. Anpheros는 FHIR R4 API와 동일한 데이터에 대한 더 간단한 REST API를 제공합니다.

개발자를 위한 무료 헬스케어 API가 있나요?

네. Anpheros 샌드박스는 무료이며 셀프 서비스입니다. Google로 로그인하고 API 키를 받아 FHIR R4 또는 REST를 통해 30명의 합성 환자와 작업할 수 있습니다. 프로덕션은 월 €99부터 시작하며 첫 달은 무료입니다.

환자는 헬스케어 API에 어떻게 동의하나요?

OAuth 2.1과 PKCE를 통해 이루어집니다. 애플리케이션은 사용자에게 SMART on FHIR 범위를 포함한 동의 페이지로 이동시키며, 사용자는 무엇을 얼마나 오래 공유할지 선택하고, 접근 로그를 확인하며, 언제든지 접근 권한을 철회할 수 있습니다.

데이터는 어디에 저장되나요?

유럽 연합 내에 저장됩니다. 서비스 및 데이터베이스는 Google Cloud europe-west4 (네덜란드)에서 실행됩니다.

어떤 헬스케어 API를 선택해야 하나요?

데이터 표준, 접근 권한 부여 주체, 출처 및 감사, 데이터 상주 위치, 재시도 및 오류 처리 방식, 무료로 현실적인 데이터로 테스트할 수 있는지 여부를 비교하세요. 헬스케어 API 플랫폼: 포함 내용 및 선택 방법에서는 이러한 내용을 모든 공급업체에 문의할 질문으로 전환합니다.