Visual Studio Code에서 REST 클라이언트 확장을 사용 하 여 의료 Api (미리 보기)에 액세스

중요

Azure 의료 Api는 현재 미리 보기로 제공 됩니다. Microsoft Azure 미리 보기에 대한 추가 사용 약관에는 베타 또는 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 추가 약관이 포함되어 있습니다.

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

REST 클라이언트 확장 설치

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

REST 클라이언트 VSCode 확장

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

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

요청 보내기

클라이언트 응용 프로그램 값 가져오기

중요

FHIR 서버 REST API (메타 데이터를 가져오지 않고)를 호출 하기 전에 응용 프로그램 등록을 완료 해야 합니다. Azure 테 넌 트 id, 클라이언트 id, 클라이언트 암호서비스 URL을 기록해 둡니다.

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

파일에 test.http 응용 프로그램을 등록 하 여 얻은 다음 정보를 포함 합니다.

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

Azure AD 액세스 토큰 가져오기

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

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

참고

grant_type의는 client_credentials 액세스 토큰을 가져오는 데 사용 됩니다.

### 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}}

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

액세스 토큰 가져오기

GET FHIR 환자 데이터

이제 요청을 통해 환자 또는 특정 환자의 목록을 가져올 수 있습니다 GET . With 줄은 Authorization 요청에 대 한 헤더 정보입니다 GET . 또한 PUTPOST FHIR 리소스를 만들거나 업데이트 하는 요청을 보낼 수 있습니다.

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

환자 받기

PowerShell 또는 CLI 실행

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

Visual Studio Code의 PowerShell

PowerShell 실행

Visual Studio Code CLI

CLI 실행

문제 해결

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

액세스 토큰을 가져올 수 없는 경우 클라이언트 응용 프로그램이 제대로 등록 되 고 응용 프로그램 등록 단계에서 올바른 값을 사용 하 고 있는지 확인 합니다.

FHIR 서버에서 데이터를 가져올 수 없는 경우 클라이언트 응용 프로그램 (또는 서비스 주체)에 FHIR 서버에 대 한 "FHIR 데이터 참가자"와 같은 액세스 권한이 부여 되었는지 확인 합니다.