Azure API for FHIR での FHIR API のテスト
前のチュートリアルでは、Azure API for FHIR をデプロイし、クライアント アプリケーションを登録しました。 これで、Azure API for FHIR をテストする準備ができました。
機能ステートメントを取得する
まず、Azure API for FHIR の capability ステートメントを取得します。
- Postman を開きます。
- を実行
GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata
して capability ステートメントを取得します。 次の図では、FHIR サーバー名が fhirserver になっています。
次に、患者の取得を試みます。 患者を取得するには、「」と入力します GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient
。 401 未承認のエラーが表示されます。 このエラーは、患者データへのアクセス権を持っていることが証明されていないために発生します。
FHIR サーバーから患者を取得する
アクセスできるようにするには、アクセス トークンが必要です。
- [ 承認] を選択し、Postman で [種類] を [OAuth2.0 ] に設定します。
- [Get New Access Token]\(新しいアクセス トークンを取得する\) を選択します。
- 各フィールドに入力し、 [Request Token]\(トークンの要求\) を選択します。 以下に、このチュートリアルでの各フィールドの値を示します。
フィールド | 値 |
---|---|
Token Name (トークン名) | トークンの名前 |
付与タイプ | Authorization Code (承認コード) |
コールバック 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> |
Scope | <BLANK> |
State | 1234 |
クライアント認証 | Send client credentials in body (本文でクライアントの資格情報を送信する) |
- 自分の資格情報でサインインし、 [Accept]\(同意する\) を選択します
- 結果を下へスクロールし、 [Use Token]\(トークンの使用\) を選択します
- 上部にある [Send]\(送信\) をもう一度選択すると、結果のが表示されます
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"
}
この POST では、"James Tiberious Kirk" という名前の新しい患者が FHIR サーバーに作成されます。
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 Active Directory が Azure API for FHIR とどのように対話するかについて概説しています。
- アクセス トークンの検証 - この攻略ガイドでは、アクセス トークンの検証について詳しく説明し、アクセスの問題を解決するための手順を示しています。
次の手順
これでクライアント アプリケーションに正常に接続できたので、Web アプリケーションを作成する準備ができました。
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。