의료 데이터 연동

Healthcare Interoperability — FHIR R4 Standard

FHIR R4 표준 API

우리들녹지국제병원은 HL7 FHIR R4 국제 표준을 준수하는 의료 데이터 API를 제공합니다. 해외 병원, 보험사, 의료 시스템과 안전하게 환자 데이터를 교환할 수 있습니다.

FHIR Resources

FHIR Version

JWT

Authentication

JSON

Format

환자 전원 프로세스

📋

Step 1

Referral Request

전원 의뢰서 작성 (진단+투약+검사)

📦

Step 2

FHIR Bundle

표준 문서로 자동 패키징 + 디지털 서명

🔐

Step 3

Secure Transfer

SMART-on-FHIR 인증 + HTTPS 전송

✅

Step 4

Confirmation

수신 확인 + 환자 자동 등록

지원 FHIR R4 리소스

PatientEncounterMedicationRequestConditionObservationImmunizationMedicationPractitionerAllergyIntoleranceProcedureAppointmentDiagnosticReportServiceRequestLocationCarePlanDocumentReferenceOrganization

Base URL: https://his.weve.io.kr/fhir/R4 | CapabilityStatement: GET /fhir/R4/metadata

연동 파트너를 위한 안내

🏥 해외 병원

• FHIR Bundle로 환자 전원 의뢰/수신
• SMART-on-FHIR 클라이언트 등록 필요
• 진단(ICD-10) + 약물(ATC) 국제 코드 사용
• 영문 진료요약서 자동 생성

💳 보험사

• 진료비 청구 데이터 FHIR 형식 제공
• DiagnosticReport + Claim 리소스
• 실시간 입원/퇴원 알림 (Webhook)
• 영문 영수증 + 진단서 API

📱 앱 개발사

• Patient/Observation 읽기 권한
• SMART App Launch (EHR Launch Context)
• OAuth2 스코프 기반 접근 제어
• Sandbox 환경 제공 예정

🇰🇷 국내 병원

• 건강정보고속도로 CDA 연동 (예정)
• CI 기반 환자 자동 매칭
• KCD-8 + EDI 코드 지원
• 전원 의뢰서/회신서 표준 양식

API 사용 예시

# 1. 인증
POST /api/v1/auth/login
Content-Type: application/json
{"email": "partner@hospital.com", "password": "..."}

# 2. 환자 검색
GET /fhir/R4/Patient?name=Kim&gender=male
Authorization: Bearer <access_token>

# 3. 검사 결과 조회
GET /fhir/R4/Observation?patient=<patient-id>
Authorization: Bearer <access_token>

# 4. 전원 의뢰
POST /api/v1/transfer/request
Authorization: Bearer <access_token>
{
  "patientId": "<patient-id>",
  "toOrgCode": "11100001",
  "urgency": "URGENT",
  "reason": "Specialist consultation required"
}

연동 파트너 등록 절차

📝

Step 1연동 신청

아래 폼으로 기관 정보와 연동 목적을 제출합니다.

즉시

🔍

Step 2심사·검증

기관 정보 검증, 연동 범위 협의, 보안 요건을 확인합니다.

3~5 영업일

🔑

Step 3승인·인증 발급

SMART Client ID/Secret 발급, Scope 및 Rate Limit을 설정합니다.

승인 즉시

🧪

Step 4Sandbox 테스트

테스트 환경에서 FHIR API 연동을 검증합니다.

1~2주

🚀

Step 5운영 전환

Production 환경 활성화, 모니터링 대시보드를 제공합니다.

검증 완료 후

📊

Step 6운영 모니터링

API 호출 통계, 에러율, 응답시간을 실시간으로 제공합니다.

상시

연동 파트너십 문의

FHIR API 접근 권한, SMART 클라이언트 등록, 기술 지원에 대해 문의하세요.

Email: fhir@wgimc.kr | Tel: +82-64-801-1000