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

在 Azure API for FHIR 上测试 FHIR API

项目
12/04/2024

重要

Azure API for FHIR 将于 2026 年 9 月 30 日停用。 按照迁移策略在该日期之前转换到 Azure Health Data Services FHIR® 服务。由于 Azure API for FHIR 停用，在 2025 年 4 月 1 日开始前不会允许新的部署。 Azure Health Data Services FHIR 服务是 Azure API for FHIR 的演化版本，可让客户管理 FHIR、DICOM 和医疗技术服务，并集成到其他 Azure 服务。

在前一教程中，你已部署 Azure API for FHIR® 并注册了客户端应用程序。现已准备好测试 Azure API for FHIR。

检索功能语句

首先，我们将获取 Azure API for FHIR 的功能语句。

打开 Postman。
使用 GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata 来检索功能语句。在下图中，FHIR 服务器名称为 fhirserver。

功能语句

接下来，我们将尝试检索患者。若要检索患者，请使用 GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient。收到 401 Unauthorized 错误的原因是你尚未证明你有权访问患者数据。

检索患者失败

从 FHIR 服务器获取患者

若要获取访问权限，需要一个访问令牌。

在 Postman 中，选择“授权”，将“类型”设置为“OAuth2.0”。
选择获取新访问令牌。
填写字段，然后选择“请求令牌”。在下面可以看到本教程中所述每个字段的值。

字段	值
令牌名称	令牌的名称
授权类型	授权代码
回调 URL	https://www.getpostman.com/oauth2/callback
身份验证 URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com
访问令牌 URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
客户端 ID	在前面的步骤中复制的客户端 ID
客户端机密	<BLANK>
范围	<BLANK>
状态	1234
客户端身份验证	在正文中发送客户端凭据

使用凭据登录，然后选择“接受”
向下滚动浏览结果，然后选择“使用令牌”
再次选择顶部的“发送”，这一次应会收到结果：

“检索患者成功”

将患者发布到 FHIR 服务器中

现已获取访问权限，接下来可以创建新患者。下面是可添加到 FHIR 服务器中的简单患者示例。将 json 输入到 Postman 的“正文”部分。

    {
        "resourceType": "Patient",
        "active": true,
        "name": [
            {
                "use": "official",
                "family": "Kirk",
                "given": [
                    "James",
                    "Tiberious"
                ]
            },
            {
                "use": "usual",
                "given": [
                    "Jim"
                ]
            }
        ],
        "gender": "male",
        "birthDate": "1960-12-25"
    }

此 POST 命令将在 FHIR 服务器中创建名为 James Tiberious Kirk 的新患者。

发布患者

如果再次使用 GET 命令来检索患者，你将看到输出中列出了 James Tiberious Kirk。

注意

将请求发送到 Azure API for FHIR 时，需要确保已将 Content-Type 标头设置为 application/json

排查访问问题

尝试从 Postman 访问患者资源时收到 403 错误。

检查是否分配了 FHIR 参与者角色；如果没有，请将 FHIR 参与者角色添加到 Azure Health Data Services。为 AHDS 配置 Azure RBAC 角色

如果在执行上述任何步骤期间遇到问题，请查看我们汇总的有关 Microsoft Entra ID 和 Azure API for FHIR 的文档。

Microsoft Entra ID 和 Azure API for FHIR - 此文档概述了 Microsoft Entra ID 的一些基本原理，以及它如何与 Azure API for FHIR 交互。
访问令牌验证 - 此操作指南提供了有关访问令牌验证的详细信息，以及解决访问问题可以采取的步骤。

后续步骤

可成功连接到客户端应用程序后，接下来可编写 Web 应用程序。

编写 Web 应用程序

注意

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

通过