Como Usar a API HL7 FHIR: Guia Completo de Integração em Saúde (2026)

Context

HL7 v2는 구분자 기반 메시지(ADT, ORM, ORU) 형식으로 웹/모바일 통합이 복잡했다. 140개 이상의 리소스 타입을 표준화된 방식으로 관리할 필요가 있었다.

Technical Solution

• RESTful API 기반 통신 도입: JSON/XML 응답 형식으로 HTTP GET/POST/PUT/PATCH/DELETE 연산 지원
• 140개 이상 FHIR 리소스 타입 정의: Patient, Practitioner, Encounter, Observation, Condition, MedicationRequest, AllergyIntolerance, Immunization, DiagnosticReport, DocumentReference 등 주요 리소스 표준화
• OAuth 2.0 및 SMART on FHIR 인증 체계 구현: granular 권한 제어를 위해 patient/Observation.read 형태의 스코프 기반 권한 관리
• FHIR 버전 관리: R4(4.0.1) STU를 현재 표준, R4B(4.3)를 테스트 버전, R5(5.0.0)를 미래 표준으로 정의하며, CMS는 R4 지원 의무화
• 메타데이터 엔드포인트를 통한 호환성 검증: CapabilityStatement 응답으로 서버 지원 리소스 타입 공시
• Bulk Data 수출($export) 연산: NDJSON 형식의 비동기 대용량 데이터 내보내기로 데이터 웨어하우스 연동

Key Takeaway

FHIR는 웹/모바일 중심의 의료 시스템 통합을 위해 메시지 기반에서 리소스 지향 설계로 전환했으며, OAuth 2.0 기반 granular 권한 제어와 표준 리소스 정의가 상호운용성의 핵심이다.