在 Azure API for FHIR 上測試 FHIR API

發行項
12/04/2024

重要

Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR® 服務。由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是 Azure API for FHIR 的進化版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。

在上一個教學課程中，您已部署 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
Client ID	您在先前步驟中複製的用戶端識別碼
用戶端密碼	<BLANK>
範圍	<BLANK>
州/省	1234
用戶端驗證	在本文中傳送用戶端認證

使用您的認證登入，並選取 [接受]
在結果上向下滾動，並選取 [使用權杖]
在頂端再次選取 [ 傳送 ]，這次您應該會得到結果：

成功患者

將病患發佈至 FHIR 伺服器

現在您已擁有存取權，您可以建立新的病患。以下是您可以新增至 FHIR 伺服器之簡單患者的範例。將此 json 輸入到 Postman 的 Body 區段中。

    {
        "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 的許可下使用。

共用方式為