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 サービスへの統合を使用して、FHIR、DICOM、および MedTech サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。

前のチュートリアルでは、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 に設定します
新しいアクセストークンの取得を選択します。
各フィールドに入力し、[Request Token]\(トークンの要求\) を選択します。以下に、このチュートリアルでの各フィールドの値を示します。

フィールド	値
Token Name (トークン名)	トークンの名前
付与タイプ	認証コード
コールバック 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
クライアントシークレット	<空白>
範囲	<空白>
都道府県	1234
クライアント認証	Send client credentials in body (本文でクライアントの資格情報を送信する)

自分の資格情報でサインインし、[Accept]\(同意する\) を選択します
結果を下へスクロールし、[Use Token]\(トークンの使用\) を選択します
上部の [送信] をもう一度選択すると、今度は次の結果が得られるはずです

成功した患者

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 では、"James Tiberious Kirk" という名前の新しい患者が FHIR サーバーに作成されます。

患者を投稿する

GET コマンドを使用して患者をもう一度取得すると、出力の一覧に James Tiberious Kirk が表示されます。

Note

Azure API for FHIR に要求を送信する場合は、確実に Content-Type ヘッダーを application/json に設定しておく必要があります

アクセスに関する問題をトラブルシューティングする

Postman から Patient リソースにアクセスしようとしたときに 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 アプリケーションを記述する

Note

FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。

次の方法で共有