在 Visual Studio Code 中使用 REST 用戶端延伸模組存取 Azure 健康資料服務

在本文中，您將瞭解如何在 Visual Studio Code 中使用 REST 用戶端延伸模組存取 Azure 健康資料服務。

安裝 REST 用戶端延伸模組

選取 Visual Studio Code 左側面板上的 [延伸模組] 圖示，然後搜尋 "REST Client"。 尋找 REST 用戶端延伸模組並進行安裝。

建立 .http 檔案並定義變數

在 Visual Studio Code 中建立新的檔案。 在檔案中輸入 GET 要求命令列，並將它儲存為 test.http。 檔案尾碼 .http 會自動啟動 REST 用戶端環境。 選取 Send Request 以取得中繼資料。

取得用戶端應用程式值

重要

呼叫 FHIR 伺服器 REST API (除了取得中繼資料) 之前，您必須先完成應用程式註冊。 請記下您的 Azure 租用戶識別碼、用戶端識別碼、 用戶端密碼和服務 URL。

雖然您可以在 REST API 的呼叫中直接使用像是用戶端識別碼的值，但您最好為這些值定義一些變數，並改成使用變數。

在您的 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 用來儲存存取權杖。

注意

client_credentials 的 grant_type 用來取得存取權杖。

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

注意

在 FHIR 服務受眾參數未對應到 FHIR 服務端點 URL 的情節中。 資源參數值應該對應至 FHIR 服務驗證刀鋒視窗下的受眾值。

GET 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 健康資料服務資料。

若要瞭解如何針對 Azure 健康資料服務中的設定檔驗證 FHIR 資源，請參閱

針對 Azure 健康資料服務中的設定檔驗證 FHIR 資源

FHIR® 是 HL7 的註冊商標，經 HL7 的許可使用。