为了维护最佳的系统稳定性和性能，Health Connect 会对客户端连接到 Health Connect API 的速率进行限制。
本指南概述了 Health Connect 中对读取和写入 API 操作施加的限制，以及如何通过高效的应用设计来避免速率限制。
API 限制
对前台和后台 API 操作都设置了**固定的请求速率配额**限制。
速率和内存限制根据您的应用执行的操作类型以及该操作是在前台还是后台执行而有所不同。
读取和更改日志限制
对于读取和更改日志限制，Health Connect 对您的应用可用的 API 调用次数施加了两个限制
- 对您的应用可以对 API 进行的 API 调用次数的周期性限制。
- 对您的应用可以进行的 API 调用的每日限制。
插入、更新和删除限制
Health Connect 对插入、更新和删除操作设置了四个不同的限制
- 对您的应用可以对 API 进行的 API 调用次数的周期性限制。
- 对您的应用可以对 API 进行的 API 调用的每日限制。
- 批量插入的内存限制。
- 单条记录插入的内存限制。
最佳实践
我们建议应用以最大限度地减少电池使用、保持最佳系统健康状况并促进所有 CRUD 操作的高效数据管理的方式与 Health Connect API 交互。
以下是一些需要遵守的最佳实践指南。
后台 API 调用
后台操作的电池使用会降低用户体验，并引发有关数据隐私的问题。
因此，后台速率限制比前台速率限制更严格。因此，限制应用在后台执行的 API 调用数量非常重要。
异常处理
如果您的应用在将数据写入 Health Connect 时遇到异常，我们建议您从异常发生的位置重试。
不要简单地删除所有相关数据并重试整个写入请求。这种方法会消耗您的插入配额，降低性能，并对电池续航时间产生负面影响。
变更日志处理
为了最大限度地降低您的应用被限速的风险，您应该利用变更日志处理 来同步您的数据库与来自 Health Connect 的数据，而不是过度依赖原始读取请求。