レート制限

101 分あたりのリクエスト数(Free のソフトリミット)、アカウント全体の値

Free ではソフトリミットが 1 分あたり 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

この動画は英語で再生されます。

動画を別のタブで開く ↗