기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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)

## 엔드포인트
<a name="attribution-status-endpoint"></a>

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

## 요청 파라미터
<a name="attribution-status-parameters"></a>

작업은 다음과 같은 선택적 파라미터를 허용합니다.


| 파라미터 | 유형 | 설명 | 
| --- | --- | --- | 
| memberId | 식별자 | 어트리뷰션 상태가 요청된 멤버의 MemberId  | 
| patientReference | 레퍼런스 | 생산자 시스템의 환자 리소스에 대한 참조 | 

**참고**  
`memberId` 검증을 위해 또는를 제공하거나 둘 다 제공할 `patientReference` 수 있습니다.

## 샘플 요청
<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>

환자와 관련된 어트리뷰션 리소스가 포함된 번들을 반환합니다.


| Resource | 카디널리티 | 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 상태 | 설명 | 
| --- | --- | --- | 
| 잘못된 작업 요청 | 400 | 규정 미준수 요청 파라미터 또는 구조 | 
| 그룹 리소스를 찾을 수 없음 | 404 | 지정된 그룹 ID가 존재하지 않습니다. | 
| 환자 리소스를 찾을 수 없음 | 404 | 지정된 환자 참조가 존재하지 않습니다. | 

## 권한 부여 및 보안
<a name="attribution-status-authorization"></a>

SMART 범위 요구 사항  
클라이언트는 그룹 리소스 및 관련 어트리뷰션 리소스를 읽을 수 있는 적절한 권한이 있어야 합니다.  
표준 FHIR 권한 부여 메커니즘은 모든 작업에 적용됩니다.