Rate-Limits

10Anfragen pro Minute (Soft-Limit im Free-Tarif), für euer ganzes Konto

Im Free-Tarif liegt das Soft-Limit bei 10 Anfragen pro Minute und das Hard-Limit bei 100, gezählt für euer ganzes Konto über alle Spieler. Bezahlte Tarife haben höhere Limits, siehe Preisseite. Anfragen über dem Hard-Limit bekommen HTTP 429 mit Retry-After. Plant eure API-Aufrufe effizient.

Machen und vermeiden

  • Daten lokal zwischenspeichern
  • Alle Configs beim Start laden
  • Punktzahlen nur bei Verbesserung einreichen
  • Den useCache-Parameter verwenden
  • Wiederholt identische Anfragen stellen
  • Einzelne Configs wiederholt abrufen
  • Punktzahlen bei jedem Frame einreichen
  • Den Cache immer umgehen

Effizientes Startmuster

Ladet beim Start nur, was ihr wirklich braucht, und verlasst euch sonst auf das Caching.

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}

Tutorial-Video

Rate-Limits3:13
Video separat öffnen ↗