为了维护最佳的系统稳定性和性能，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 中的数据同步，而不是过度依赖原始读取请求。