속도 제한

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

이 동영상은 영어로 재생됩니다.

동영상 별도로 열기 ↗