API pública
JSON de solo lectura para bots de Discord, webs de fans y herramientas: estado del servidor, jugadores conectados y rankings. No hace falta clave.
Reglas
- Máximo 60 solicitudes por minuto por dirección IP; por encima recibes HTTP 429 con Retry-After.
- CORS está abierto (Access-Control-Allow-Origin: *), así que una página web puede llamarlo directamente.
- El estado se actualiza cada 30 segundos y los rankings cada pocos minutos; no consultes más rápido.
Endpoints
| GET | Devuelve |
|---|---|
/api/v1/status | Servidor de login y de juego activo/caído, jugadores en el juego, hora del servidor. |
/api/v1/online | Solo el número de jugadores en el juego (para el comando /online de un bot). |
/api/v1/rankings/<board>?limit=50 | Mejores personajes, brigadas o naciones (líderes y NCP). Rankings:level, war, pvp, playtime, brigade, nation |
Ejemplo
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}, ...]}
Los errores también son JSON: {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).