公平使用与速率限制

UAPI 致力于为广大开发者提供一个免费、开放且稳定的 API 服务平台。为了确保服务的可用性和对所有用户的公平性，我们实施了相应的公平使用政策。

动态智能的速率限制

与传统的固定阈值不同，UAPI 采用了一套先进的动态速率限制架构。该系统会实时监测我们服务器集群的整体健康状况与资源负载，并据此智能地调整每个用户、每个端点的请求速率上限。

这种设计的优势在于：

• 弹性与韧性：在服务器负载较低时，您可以享有更高的请求速率，充分利用可用资源；当系统繁忙时，限制会自动收紧，保护核心服务不被拖垮，确保所有用户的基本可用性。
• 公平调度：系统能识别出异常的、高频的请求模式，并对其进行隔离，从而保障了其他正常用户的服务质量。

我们的建议

尽管速率限制是动态的，但为了您的应用能与 UAPI 顺畅协作，我们强烈建议您在设计应用时遵循以下最佳实践：

• 合理规划请求频率。请避免在短时间内（例如几秒内）发起密集的并发请求。对于大多数应用，将平均请求速率控制在 40 次/分钟 以内是一个安全且合理的设计目标。这能确保您的应用在任何时候都不会对我们的服务造成瞬时压力。
• 为您的 API 调用加入带有指数退避策略的重试逻辑。当您收到 429 Too Many Requests 响应时，不应立即重试，而应等待一个逐渐增长的时间间隔。
• 尽可能缓存 API 的响应结果。对于那些不经常变化的数据，缓存是降低 API 调用次数、提升您自己应用性能的最有效手段。

我们相信，一个设计良好、行为友好的应用，将极少会触发我们的速率限制。