速率限制

10每分钟请求数(Free 套餐的软限制),按你的整个账号计

Free 套餐的软限制为每分钟 10 次请求,硬限制为 100 次,按你的整个账号统计,涵盖所有玩家。付费套餐的限制更高,请查看价格页面。超过硬限制的请求会收到带有 Retry-After 的 HTTP 429。请高效地设计你的 API 调用。

建议与避免

  • 在本地缓存数据
  • 在启动时加载所有配置
  • 仅在成绩提升时提交分数
  • 使用 useCache 参数
  • 反复发送相同的请求
  • 反复获取单个配置
  • 每一帧都提交分数
  • 始终绕过缓存

高效的启动模式

启动时只加载你需要的内容,其余的交给缓存处理。

Unity (C#)
C#
1async void Start()
2{
3 HorizonApp.Initialize();
4 await new HorizonServer().Connect();
5​
6 // Startup loads (3 requests)
7 await UserManager.Instance.CheckAuth();
8 await RemoteConfigManager.Instance.GetAllConfigs();
9 await NewsManager.Instance.LoadNews();
10​
11 // Startup costs 3 requests. The per-minute limit counts for your whole account, not per player.
12}

教程视频

速率限制3:36

此教程以英语播放。

单独打开视频 ↗