기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
HealthLake에 대한 FHIR R4 $attribution-status 작업
특정 멤버의 어트리뷰션 상태를 검색하여 환자와 관련된 모든 어트리뷰션 리소스가 포함된 번들을 반환합니다. 이 작업은 FHIR 멤버 속성(ATR) 목록 IG 2.1.0 구현의 일부입니다.
엔드포인트
POST [base]/Group/[id]/$attribution-status
요청 파라미터
작업은 다음과 같은 선택적 파라미터를 허용합니다.
| 파라미터 | 유형 | 설명 |
|---|---|---|
| memberId | 식별자 | 어트리뷰션 상태가 요청된 멤버의 MemberId |
| patientReference | 레퍼런스 | 생산자 시스템의 환자 리소스에 대한 참조 |
참고
memberId 검증을 위해 또는를 제공하거나 둘 다 제공할 patientReference 수 있습니다.
샘플 요청
{ "resourceType": "Parameters", "parameter": [ { "name": "memberId", "valueIdentifier": { "system": "http://example.org", "value": "MBR123456789" } }, { "name": "patientReference", "valueReference": { "reference": "Patient/patient-123", "display": "John Doe" } } ] }
응답
환자와 관련된 어트리뷰션 리소스가 포함된 번들을 반환합니다.
| 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 |
샘플 응답
{ "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 권한 부여 메커니즘은 모든 작업에 적용됩니다.