Öffentliche API

Schreibgeschütztes JSON für Discord-Bots, Fanseiten und Tools: Serverstatus, Spieler online und Ranglisten. Kein Schlüssel nötig.

Regeln

Höchstens 60 Anfragen pro Minute und IP-Adresse; darüber erhältst du HTTP 429 mit Retry-After.
CORS ist offen (Access-Control-Allow-Origin: *), eine Webseite kann ihn also direkt aufrufen.
Der Status wird alle 30 Sekunden aktualisiert, die Ranglisten alle paar Minuten; frag nicht häufiger ab.

Endpunkte

GET	Rückgabe
`/api/v1/status`	Login- und Spielserver online/offline, Spieler im Spiel, Serverzeit.
`/api/v1/online`	Nur die Anzahl der Spieler im Spiel (für den /online-Befehl eines Bots).
`/api/v1/rankings/<board>?limit=50`	Top-Charaktere, -Brigaden oder -Nationen (Anführer und NCP). Ranglisten: `level, war, pvp, playtime, brigade, nation`

Beispiel

curl https://acerivals.com/api/v1/status

{"online": true, "login_server": true, "game_server": true, "players": 12,
 "server_time": "2026-10-30T21:00:00+03:00", "checked_at": "2026-10-30T21:00:00"}

curl "https://acerivals.com/api/v1/rankings/level?limit=3"

{"board": "level", "updated_at": "...", "rows": [
  {"rank": 1, "name": "AcePilot", "nation": "BCU", "gear": "I", "level": 110,
   "brigade": "Falcons", "war_points": 5000, "pvp_wins": 12, "play_hours": 25}, ...]}

Fehler sind ebenfalls JSON: {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).