Public API

Read-only JSON for Discord bots, fan sites and tools: server status, players online and rankings. No key needed.

Rules

At most 60 requests per minute per IP address; above that you get HTTP 429 with Retry-After.
CORS is open (Access-Control-Allow-Origin: *), so a web page can call it directly.
Status is refreshed every 30 seconds, rankings every few minutes; poll no faster than that.

Endpoints

GET	Returns
`/api/v1/status`	Login and game server up/down, players in game, server time.
`/api/v1/online`	Only the number of players in game (for a bot's /online command).
`/api/v1/rankings/<board>?limit=50`	Top characters, brigades or nations (leaders and NCP). Boards: `level, war, pvp, playtime, brigade, nation`

Example

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}, ...]}

Errors are JSON too: {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).