건강 데이터 API: 무엇을 살펴보고, 환자 기록을 1시간 안에 읽고 쓰는 방법

"의료 API"는 병원의 HL7 v2 피드, 국가 전자처방 서비스, 웨어러블 기기 공급업체의 내보내기, FHIR 서버 등 매우 다양한 것을 포함합니다. 건강 앱, 클리닉 도구 또는 AI 비서를 구축하는 경우 필요한 것은 환자의 기록을 표준 형식으로 보유하고, 환자가 누가 읽을지 결정할 수 있도록 하며, 이를 통해 깔끔한 API를 제공하는 백엔드입니다. 이 가이드에서는 무엇을 찾아야 하는지 설명하고 Anpheros Platform에서의 첫 시간을 실제 호출과 함께 보여줍니다.

개발자를 위한 기술 버전: 의료 API · 의료 데이터 API (developers.anpheros.com에서 요청, 응답 및 제한 사항 포함). 이 페이지는 일반 언어 버전입니다.

의료 데이터 API가 해야 할 일

사용 가능한 건강 데이터 API와 HTTP가 앞에 붙은 데이터베이스를 구분하는 다섯 가지 요소가 있습니다.

• 표준 형식. HL7 FHIR R4는 병원, 국가 시스템 및 EU의 건강 데이터 공간에서 사용하는 형식입니다. FHIR로 저장된 기록은 사용자 정의 브릿지 없이 다른 시스템에서 읽을 수 있습니다. 독점 JSON은 그렇지 않습니다.
• 최우선 객체로서의 환자 동의. 누가 무엇을 얼마나 오래 읽을 수 있는지, 취소 가능하며 환자에게 보이는지 여부입니다. 자체 데이터베이스의 체크박스가 아닙니다.
• 출처. 모든 값은 누가 작성했는지 나타냅니다: 환자, 의료진, 기기, 가져오기, 파생된 계산. 검사 결과와 스스로 보고한 추측을 구별할 수 없는 AI 비서는 위험합니다.
• 현실적인 데이터를 갖춘 샌드박스. 실제 환자로 테스트할 수 없으며, 6개월의 기록을 가진 30개의 합성 환자를 직접 만들어야 할 필요도 없습니다.
• 지정 가능한 데이터 상주 위치. 유럽 사용자의 경우 GDPR에 따라 EU 내 서버와 데이터 처리 계약이 필요합니다.

두 가지 접근 방식: REST 및 FHIR, 동일한 데이터

Anpheros Platform은 동일한 기록을 두 번 노출합니다. 제품 코드용 간단한 REST API (/v1)와 나머지 의료 시스템과 통신해야 하는 모든 것을 위한 엄격한 FHIR R4 (/fhir/R4)입니다. ID는 둘 다 동일하며, 모든 v1 객체는 fhir 참조를 포함합니다.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# 프로젝트에서 볼 수 있는 환자
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# 최신순 검사 결과
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# 활성 약물
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# 타임라인의 모든 것
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# 동일한 데이터, 엄격한 FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

이 호출 뒤에는 26개의 FHIR 리소스 유형(환자, 관찰, 질병, 약물 진술, 알레르기 불내성, 예방 접종, 문서 참조, 만남, 동의, 출처 등)이 있으며, 측정값은 LOINC, 질병은 ICD-10, 약물은 ATC로 코딩됩니다.

키를 받는 데 1분이 걸립니다

샌드박스는 셀프 서비스이며 무료입니다. platform.anpheros.com/dashboard에서 대시보드에 로그인하고 샌드박스 키 받기를 누르면 조직, 샌드박스 프로젝트 및 sk_test_… 키를 얻을 수 있습니다. 프로젝트에는 30명의 합성 환자(EU 전역의 성인, 어린이 및 노인, 6개월간의 질병, 약물, 알레르기, 검사 결과 및 활력 징후 포함) 복사본이 함께 제공됩니다. 무엇이든 변경하거나 삭제할 수 있습니다. 재설정하면 다시 돌아옵니다.

프로덕션 키(sk_live_…)는 서명된 데이터 처리 계약이 있는 검증된 조직에 제공됩니다. 샌드박스와 프로덕션은 다른 데이터베이스입니다. 샌드박스 키는 실제 환자에게 물리적으로 접근할 수 없습니다.

상자에 들어 있는 다른 것들

• OAuth 2.1 with PKCE 및 SMART on FHIR 독립 실행형 시작을 통해 앱이 개인에게 자신의 기록에 대한 액세스를 요청할 수 있습니다.
• 범위, 만료 및 취소가 포함된 동의 및 환자가 읽을 수 있는 액세스 로그.
• 서명된 웹훅 (resource.created, consent.granted, consent.revoked, document.finalized에 대한 HMAC-SHA256, 백오프 재시도).
• AI 컨텍스트 API로 토큰 예산 내에서 환자의 출처 레이블이 지정된 요약을 구축합니다.
• CSV, HL7 v2 ORU^R01 또는 JSON에서 실험실 보고서 가져오기, LOINC에 매핑됩니다.
• 국제 환자 요약 ($summary) 및 QR 공유를 위한 SMART Health Links.
• Dart 및 TypeScript용 SDK, /docs의 OpenAPI 참조 및 /fhir/R4/metadata의 CapabilityStatement.

응답이 포함된 전체 안내는 developers.anpheros.com/guides/first-hour에서 확인할 수 있습니다.

자주 묻는 질문

오늘 바로 시작할 수 있는 무료 의료 API가 있나요?

네. Anpheros 샌드박스는 무료이며 셀프 서비스입니다. 로그인하고 키를 받으면 읽고 쓸 수 있는 30명의 합성 환자가 있습니다. 제한 사항은 프로젝트당 하루 10,000개의 리소스 쓰기, 자체 환자 100명, 문서 250MB입니다.

REST 또는 FHIR, 어떤 것을 사용해야 하나요?

자체 제품 코드에는 /v1을 사용하세요. 더 간단하고 일반 JSON을 반환합니다. 다른 시스템에서 데이터를 읽어야 하거나, FHIR 검색, _history, $everything 또는 $summary가 필요하거나, 인증에서 요청하는 경우 /fhir/R4를 사용하세요. 둘 다 동일한 기록을 봅니다.

환자 동의는 어떻게 처리되나요?

개인은 OAuth를 통해 애플리케이션에 자신의 기록에 대한 액세스를 부여하고, 범위와 기간(30, 90, 180 또는 365일)을 선택합니다. 부여는 언제든지 취소할 수 있으며, 환자는 액세스 로그에서 모든 읽기 기록을 볼 수 있습니다. 자세한 내용은 동의 모델을 참조하세요.

데이터는 어디에 호스팅되나요?

유럽 연합(Cloud Run, europe-west4)에 호스팅되며, 모든 쓰기에 대해 출처 및 버전 기록이 유지됩니다. 프로덕션 사용에는 서명된 데이터 처리 계약이 필요합니다.

프로덕션 비용은 얼마인가요?

프로덕션은 2,500명의 저장된 환자에 대해 월 €49부터 시작하며, 첫 달은 무료입니다. 더 큰 요금제는 월 €199 및 €799입니다. 샌드박스는 무료로 유지됩니다. 가격을 참조하세요.

AI 에이전트와 작동하나요?

네. 출처 레이블과 토큰 예산이 있는 AI 컨텍스트 API와 MCP 지원 보조 장치가 연결할 수 있는 platform.anpheros.com/mcp의 MCP 서버가 있습니다. AI 의료 보조 장치와의 EMR 통합을 참조하세요.