本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
HealthLake 的 FHIR R4 $attribution-status操作
擷取特定成員的屬性狀態,傳回包含與病患相關所有屬性資源的套件。此操作是 FHIR 成員屬性 (ATR) List IG 2.1.0 實作的一部分。
Endpoint
POST [base]/Group/[id]/$attribution-status
請求參數
操作接受下列選用參數:
| 參數 | 類型 | 描述 |
|---|---|---|
| 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 授權機制適用於所有操作