核心概念

公平使用政策

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

动态速率限制

UAPI 会结合当前整体访问情况动态调整请求限制。在服务繁忙时,平台会优先保证大多数正常请求能够继续使用。

这样做主要是为了:

  • 保持可用性:在访问量波动时,尽量让服务继续稳定可用。
  • 保障公平性:对于异常频繁或明显不合理的请求,平台会进行限制,避免影响其他用户。

我们的建议

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

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

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