API pubblica
JSON di sola lettura per bot Discord, siti di fan e strumenti: stato del server, giocatori online e classifiche. Nessuna chiave necessaria.
Regole
- Al massimo 60 richieste al minuto per indirizzo IP; oltre ricevi HTTP 429 con Retry-After.
- CORS è aperto (Access-Control-Allow-Origin: *), quindi una pagina web può chiamarlo direttamente.
- Lo stato si aggiorna ogni 30 secondi, le classifiche ogni pochi minuti; non interrogare più spesso.
Endpoint
| GET | Restituisce |
|---|---|
/api/v1/status | Server di login e di gioco attivo/inattivo, giocatori in gioco, ora del server. |
/api/v1/online | Solo il numero di giocatori in gioco (per il comando /online di un bot). |
/api/v1/rankings/<board>?limit=50 | Migliori personaggi, brigate o nazioni (leader e NCP). Classifiche:level, war, pvp, playtime, brigade, nation |
Esempio
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}, ...]}Anche gli errori sono in JSON: {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).