Visual Studio Code에서 REST 클라이언트 확장을 사용하여 Azure Health Data Services에 액세스

이 문서에서는 Visual Studio Code에서 REST 클라이언트 확장을 사용하여 Azure Health Data Services에 액세스하는 방법을 알아봅니다.

REST 클라이언트 확장 설치

Visual Studio Code의 왼쪽 패널에서 확장 아이콘을 선택하고 "REST 클라이언트"를 검색합니다. REST 클라이언트 확장을 찾아 설치합니다.

.http 파일 만들기 및 변수 정의

Visual Studio Code에 새 파일을 만듭니다. 파일에 GET 요청 명령줄을 입력하고 test.http로 저장합니다. 파일 접미사 .http는 REST 클라이언트 환경을 자동으로 활성화합니다. Send Request를 선택하여 메타데이터를 가져옵니다.

클라이언트 애플리케이션 값 가져오기

REST API 호출에서 클라이언트 ID와 같은 값을 직접 사용할 수 있지만 이러한 값에 대한 몇 가지 변수를 정의하고 대신 변수를 사용하는 것이 좋습니다.

test.http 파일에 애플리케이션 등록에서 가져온 다음 정보를 포함합니다.

### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....

Microsoft Entra 액세스 토큰 가져오기

test.http 파일에 다음 정보를 포함한 후 Send Request을(를) 누릅니다. 액세스 토큰이 포함된 HTTP 응답이 표시됩니다.

@name을 시작하는 줄에는 액세스 토큰이 포함된 HTTP 응답을 캡처하는 변수가 포함됩니다. @token 변수는 액세스 토큰을 저장하는 데 사용됩니다.

### Get access token 
# @name getAADToken 
POST https://login.microsoftonline.com/{{tenantid}}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&resource={{fhirurl}}
&client_id={{clientid}}
&client_secret={{clientsecret}}
&scope={{fhirurl}}/.default

### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}

FHIR 환자 데이터 가져오기

이제 GET 요청으로 환자나 특정 환자의 목록을 가져올 수 있습니다. Authorization 줄은 GET 요청의 헤더 정보입니다. PUT 또는 POST 요청을 보내 FHIR 리소스를 만들거나 업데이트할 수도 있습니다.

### GET Patient 
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}

PowerShell 또는 CLI 실행

Visual Studio Code 내에서 PowerShell 또는 CLI 스크립트를 실행할 수 있습니다. CTRL 및 ~ 키를 누르고 PowerShell 또는 Bash를 선택합니다. 통합 터미널에 대한 자세한 내용을 확인할 수 있습니다.

Visual Studio Code에서 PowerShell

Visual Studio Code에서 CLI

문제 해결

메타데이터를 가져올 수 없는 경우(HL7 사양에 따라 액세스 토큰이 필요하지 않음) FHIR 서버가 제대로 실행되고 있는지 확인합니다.

액세스 토큰을 가져올 수 없으면 클라이언트 애플리케이션이 올바르게 등록되어 있고 애플리케이션 등록 단계에서 올바른 값을 사용하고 있는지 확인합니다.

FHIR 서버에서 데이터를 가져올 수 없으면 클라이언트 애플리케이션(또는 서비스 주체)에게 FHIR 서버에 대한 "FHIR 데이터 기여자"와 같은 액세스 권한이 부여되었는지 확인합니다.

다음 단계

이 문서에서는 Visual Studio Code에서 REST 클라이언트 확장을 사용하여 Azure Health Data Services 데이터에 액세스하는 방법을 알아봅니다.

Azure Health Data Services에서 프로필에 대해 FHIR 리소스 유효성을 검사하는 방법은 다음을 참조하세요.