HealthLake の FHIR R4 $attribution-statusオペレーション - AWS HealthLake
Endpointリクエストパラメーターリクエスト例応答エラー処理認可とセキュリティ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

HealthLake の FHIR R4 $attribution-statusオペレーション

特定のメンバーの属性ステータスを取得し、患者に関連するすべての属性リソースを含むバンドルを返します。このオペレーションは、FHIR メンバー属性 (ATR) リスト IG 2.1.0 実装の一部です。

Endpoint

POST [base]/Group/[id]/$attribution-status

リクエストパラメーター

オペレーションでは、次のオプションパラメータを使用できます。

パラメータ Type 説明
memberId 識別子 属性ステータスがリクエストされるメンバーの MemberId
patientReference リファレンス プロデューサーのシステム内の患者リソースへの参照
注記

検証目的でpatientReference、 memberIdまたは のいずれか、または両方を指定できます。

リクエスト例

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "memberId",
      "valueIdentifier": {
        "system": "http://example.org",
        "value": "MBR123456789"
      }
    },
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/patient-123",
        "display": "John Doe"
      }
    }
  ]
}

応答

患者に関連する属性リソースを含むバンドルを返します。

[リソース] カーディナリティ ロケーション
患者 1..1 Group.member.entity
カバレッジ 0..1 Group.member.extension:coverageReference
Organization/Practitioner/PractitionerRole 0..1 Group.member.extension:attributedProvider
任意のリソース 0..1 Group.member.extension:associatedData

レスポンス例

{
  "resourceType": "Bundle",
  "id": "bundle-response",
  "meta": {
    "lastUpdated": "2014-08-18T01:43:33Z"
  },
  "type": "collection",
  "entry": [
    {
      "fullUrl": "http://example.org/fhir/Patient/12423",
      "resource": {
        "resourceType": "Patient",
        "id": "12423",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2014-08-18T01:43:31Z"
        },
        "active": true,
        "name": [
          {
            "use": "official",
            "family": "Chalmers",
            "given": ["Peter", "James"]
          }
        ],
        "gender": "male",
        "birthDate": "1974-12-25"
      }
    },
    {
      "fullUrl": "http://example.org/fhir/Coverage/123456",
      "resource": {
        "resourceType": "Coverage",
        "id": "1"
        // ... additional Coverage resource details
      }
    },
    {
      "fullUrl": "http://example.org/fhir/Organization/666666",
      "resource": {
        "resourceType": "Organization",
        "id": "2"
        // ... additional Organization resource details
      }
    }
  ]
}

エラー処理

オペレーションは、次のエラー条件を処理します。

エラー HTTP ステータス 説明
無効なオペレーションリクエスト 400 非準拠のリクエストパラメータまたは構造
グループリソースが見つかりません 404 指定されたグループ ID は存在しません
患者リソースが見つかりません 404 指定された患者リファレンスは存在しません

認可とセキュリティ

SMART スコープの要件

クライアントには、グループリソースおよび関連する属性リソースを読み取るための適切な権限が必要です

標準の FHIR 認可メカニズムがすべてのオペレーションに適用されます