本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CMS 合规性功能
AWS HealthLake 提供的功能可帮助您满足 CMS（医疗保险和医疗补助服务中心）互操作性和合规性要求。这些功能使您能够按内容管理系统类别跟踪 API 使用情况，然后报告使用情况指标以实现合规性。
CMS 互操作端点
概述
HealthLake 提供了四个 CMS 互操作性端点，它们对应于 CMS 规定的 API 类别。 HealthLake 数据存储的底层基本 URL 不会改变。这些端点只是提供了一种对您的 API 调用进行分类和跟踪的方法，以便进行 CMS 报告。
用途
这些互操作性端点的主要目的是使客户能够：
-
按内容管理系统类别@@ 轻松跟踪 API 交易
-
自动报告 CMS 合规性的使用量指标
-
只需最少的更改即可@@ 维护现有的 FHIR 工作流程
无论您使用互操作性端点还是标准的 FHIR 端点，所有 API 调用的功能都是一样的，唯一的区别是如何按指标对交易进行分类。 CloudWatch
支持的 CMS 互操作端点
| 内容管理系统类别 | 互操作性端点 | 示例用法 |
|---|---|---|
| 患者通道 | /patientaccess/v2/r4 |
baseURL/patientaccess/v2/r4/Patient/123 |
| 提供商访问权限 | /provideraccess/v2/r4 |
baseURL/provideraccess/v2/r4/Observation?patient=123 |
| 付款人对付款人 | /payertopayerdx/v2/r4 |
baseURL/payertopayerdx/v2/r4/Practitioner/456 |
| 先前的身份验证服务 | /priorauthservice/v2/r4 |
baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 |
互操作性端点的工作原理
标准 HealthLake API 调用：
baseURL/resourceType/[id] baseURL/resourceType?[parameters]
使用 CMS 互操作性端点：
baseURL/interoperability-endpoint/resourceType/[id] baseURL/interoperability-endpoint/resourceType?[parameters]
只需在您的基本 URL 和资源类型之间插入互操作性端点路径即可。互操作性端点路径之后的所有内容都与您当前的 API 调用完全相同。
用法示例
示例 1：患者访问 API
当前的 API 调用（仍然有效）：
curl -X GET \ https://healthlake.us-east-1.amazonaws.com/datastore/abc123/r4/Patient/123 \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/fhir+json"
使用患者访问互操作性端点（用于 CMS 跟踪）：
curl -X GET \ https://healthlake.us-east-1.amazonaws.com/datastore/abc123/patientaccess/v2/r4/Patient/123 \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/fhir+json"
要点：
-
基本网址保持不变：
https://healthlake.us-east-1.amazonaws.com/datastore/abc123 -
已插入互操作性端点：
/patientaccess/v2/r4 -
资源路径未更改：
/Patient/123 -
两个呼叫都返回相同的响应
-
互操作性端点调用将在下方
URIType=patient-access自动跟踪 CloudWatch -
POST、PUT、PATCH、DELETE 操作的工作原理相同。
-
请求正文保持不变。
端点翻译参考
| 互操作性端点 | 翻译为 | 内容管理系统类别 |
|---|---|---|
baseURL/patientaccess/v2/r4/Patient |
baseURL/r4/Patient |
患者通道 |
baseURL/provideraccess/v2/r4/Observation |
baseURL/r4/Observation |
提供商访问权限 |
baseURL/payertopayerdx/v2/r4/Practitioner/456 |
baseURL/r4/Practitioner/456 |
付款人对付款人 Data Exchange |
baseURL/priorauthservice/v2/r4/ExplanationOfBenefit?patient=789 |
baseURL/r4/ExplanationOfBenefit?patient=789 |
事先授权 |
重要提示
-
无功能差异：互操作性端点和标准 FHIR 端点返回相同的响应并支持相同的操作
-
基本 URL 未更改：您的 HealthLake 数据存储端点保持不变
-
简单集成：在基本 URL 和资源类型之间插入互操作性端点路径
-
自动跟踪： CloudWatch 指标根据使用的互操作性端点自动对呼叫进行分类
-
向后兼容：没有互操作端点的现有 API 调用可以继续正常工作
增强了 CMS 合规性 CloudWatch 指标
概述
当您使用 CMS 互操作性端点时， HealthLake 会自动生成带有额外维度的增强 CloudWatch 指标，以支持 CMS 报告要求。这些指标按呼叫者身份、应用程序和特定于 CMS 的 URI 类型跟踪 API 使用情况，无需进行任何其他配置。
工作原理
当你使用互操作性端点进行 API 调用时：
# This call... curl https://healthlake.us-east-1.amazonaws.com/datastore/abc123/patientaccess/v2/r4/Patient/123 # Automatically generates metrics with: # - URIType: "patient-access" # - Sub: extracted from your bearer token (SMART on FHIR datastores only) # - ClientId: extracted from your bearer token (SMART on FHIR datastores only) # - Plus all standard dimensions (DatastoreId, Operation, etc.)
不需要额外的代码或配置。只需使用互操作性端点，即可自动捕获增强的指标。
注意
对于非 Smart on FHIR 数据存储，仍会捕获URIType维度，从而允许您按内容管理系统类别跟踪 API 使用情况。Sub和ClientId维度仅在使用包含这些声明的不记名令牌进行 FHIR 身份验证的 SMART 时可用。
新的指标维度
使用互操作性端点时DatastoreId，DatastoreType除了现有维度（、、Operation）之外，还会自动添加以下维度：
| 维度 | 说明 | 示例值 | 来源 |
|---|---|---|---|
| URIType | CMS 合规性类别 | patient-access, provider-access, payer-to-payer, prior-authorization |
根据互操作性端点路径自动确定 |
| Sub | 来电者身份 | 用户/实体标识符 | 摘自不记名代币索赔 sub |
| ClientId | 应用程序标识符 | portal_app, ehr_system |
摘自不记名代币索赔 client_id |
可用指标
现在，使用互操作性终端节点时，所有现有 HealthLake 指标都包含其他维度：
-
CallCount-API 调用总数
-
延迟-API 响应时间（以毫秒为单位）
-
UserErrors-4xx 个客户端错误的计数
-
SystemErrors-5xx 服务器错误计数
-
Throttles-受限制的请求数
-
SuccessfulRequests-成功的 API 调用次数
在中查询指标 CloudWatch
CloudWatch 见解查询示例
按应用程序查询所有 Patient Access API 调用：
SELECT SUM(CallCount) FROM "AWS/HealthLake" WHERE DatastoreId = '75c1cf9b0d71cd38fec8f7fb317c4c1a' AND URIType = 'patient-access' GROUP BY ClientId
