在 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 资源，请参阅