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

[アーティクル]
06/01/2023

前のチュートリアルでは、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 アプリケーションを作成する準備ができました。

Web アプリケーションを記述する

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

Share via