Azure API for FHIR での FHIR API のテスト

[アーティクル]
10/17/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 権限がありません" が返されます。このエラーは、患者データへのアクセス権を持っていることが証明されていないために発生します。

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 に設定しておく必要があります

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

これらの手順の実行中に問題が発生した場合は、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 の許可を得て使用しています。

次の方法で共有