在 Azure API for FHIR 上測試 FHIR API
在上一個教學課程中,您已部署 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 未經授權錯誤。 此錯誤是因為您尚未證明您應該具有病患資料的存取權。
從 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 |
用戶端識別碼 | 您在先前步驟中複製的用戶端識別碼 |
用戶端密碼 | <BLANK> |
影響範圍 | <BLANK> |
State | 1234 |
用戶端驗證 | 在主體中傳送用戶端認證 |
- 使用您的認證登入,並選取 [接受]
- 在結果上向下滾動,並選取 [使用權杖]
- 在頂端再次選取 [傳送 ],這次您應該會收到
將病患發佈至 FHIR 伺服器
既然您具有存取權,您便可以建立新病患。 以下是您可以新增至 FHIR 伺服器之簡單病患的範例。 在 Postman 的[本文]區段中輸入此專案 json
。
{
"resourceType": "Patient",
"active": true,
"name": [
{
"use": "official",
"family": "Kirk",
"given": [
"James",
"Tiberious"
]
},
{
"use": "usual",
"given": [
"Jim"
]
}
],
"gender": "male",
"birthDate": "1960-12-25"
}
此文章會在您的 FHIR 伺服器中使用名稱 James Tiberious Kirk 建立新病患。
如果您再次執行 GET 命令來擷取病患,您會看到輸出中所列的 James Tiberious Kirk。
注意
將要求傳送至 Azure API for FHIR 時,您必須確定您已將內容類型標頭設定為 application/json
疑難排解存取問題
如果您在上述任何步驟中遇到問題,請參閱我們在 Azure Active Directory 和 Azure API for FHIR 上匯集在一起的文件。
- Azure AD 和 Azure API for FHIR - 此文件概述 Azure Active Directory 的一些基本原則,以及其如何與 Azure API for FHIR 互動。
- 存取權杖驗證 - 本操作指南提供有關存取權杖驗證與解決存取問題需採取步驟的更具體詳細資料。
後續步驟
既然您可以成功連線到用戶端應用程式,您就可以開始撰寫 Web 應用程式。
FHIR® 是 HL7 的注冊商標,可與 HL7 的許可權搭配使用。