Share via

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Visual Studio Code 中使用 REST 客户端扩展访问 Azure Health Data Services

  • 项目

本文介绍如何在 Visual Studio Code 中使用 REST 客户端扩展访问 Azure Health Data Services。

安装 REST 客户端扩展

选择 Visual Studio Code 左侧面板中的“扩展”图标，然后搜索“REST 客户端”。 查找 REST 客户端扩展并安装。

REST Client VSCode extension

创建 .http 文件并定义变量

在 Visual Studio Code 中创建新文件。 GET在文件中输入请求命令行，并将其另存为 test.http。 文件后缀 .http 会自动激活 REST 客户端环境。 选择 Send Request 以获取元数据。

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....

获取 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}}

Get access token

注意

在 FHIR 服务受众参数未映射到 FHIR 服务终结点 URL 的情况下。 资源参数值应映射到 FHIR 服务身份验证边栏选项卡下的受众值。

GET FHIR 患者数据

现在可以获取具有请求的病人或特定患者 GET 的列表。 其行 Authorization 是请求的 GET 标头信息。 还可以发送 PUT 或 POST 请求创建/更新 FHIR 资源。

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

GET Patient

运行 PowerShell 或 CLI

可以在 Visual Studio Code 中运行 PowerShell 或 CLI 脚本。 按 CTRL 键 ~ 并选择 PowerShell 或 Bash。 有关集成终端的更多详细信息。

Visual Studio Code 中的 PowerShell

running PowerShell

Visual Studio Code 中的 CLI

running CLI

疑难解答

如果无法获取元数据（不需要基于 HL7 规范的访问令牌），检查 FHIR 服务器正常运行。

如果无法获取访问令牌，请确保客户端应用程序已正确注册，并且正在使用应用程序注册步骤中的正确值。

如果无法从 FHIR 服务器获取数据，请确保已向客户端应用程序（或服务主体）授予对 FHIR 服务器的“FHIR 数据参与者”等访问权限。

后续步骤

本文介绍了如何使用 Visual Studio Code 中的 REST 客户端扩展访问 Azure Health Data Services 数据。

若要了解如何根据 Azure Health Data Services 中的配置文件验证 FHIR 资源，请参阅

根据 Azure Health Data Services 中的配置文件验证 FHIR 资源

FHIR® 是 HL7 的注册商标，经 HL7 许可使用。