本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# HealthLake 的 FHIR R4 `$attribution-status`操作
<a name="reference-fhir-operations-attribution-status"></a>

擷取特定成員的屬性狀態，傳回包含與病患相關所有屬性資源的套件。此操作是 [FHIR 成員屬性 (ATR) 清單 IG 2.1.0 實作的一部分。](https://build.fhir.org/ig/HL7/davinci-atr/spec.html)

## Endpoint
<a name="attribution-status-endpoint"></a>

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

## 請求參數
<a name="attribution-status-parameters"></a>

操作接受下列選用參數：


| 參數 | 類型 | 說明 | 
| --- | --- | --- | 
| memberId | 識別符 | 請求其屬性狀態之成員的 MemberId  | 
| patientReference | 參考資料 | 生產者系統中病患資源的參考 | 

**注意**  
`patientReference` 可以提供 `memberId`或 ，或兩者都用於驗證目的。

## 請求範例
<a name="attribution-status-request-example"></a>

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

## 回應
<a name="attribution-status-response"></a>

傳回包含與病患相關屬性資源的套件：


| 資源 | 基數 | Location | 
| --- | --- | --- | 
| 病患 | 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 | 

### 回應範例
<a name="attribution-status-response-example"></a>

```
{
  "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
      }
    }
  ]
}
```

## 錯誤處理
<a name="attribution-status-error-handling"></a>

操作會處理下列錯誤條件：


| 錯誤 | HTTP 狀態 | Description | 
| --- | --- | --- | 
| 無效的操作請求 | 400 | 不符合的請求參數或結構 | 
| 找不到群組資源 | 404 | 指定的群組 ID 不存在 | 
| 找不到病患資源 | 404 | 指定的病患參考不存在 | 

## 授權和安全性
<a name="attribution-status-authorization"></a>

SMART 範圍需求  
用戶端必須具有適當的權限，才能讀取群組資源和相關歸因資源  
標準 FHIR 授權機制適用於所有操作