API pública

JSON somente leitura para bots do Discord, sites de fãs e ferramentas: status do servidor, jogadores online e rankings. Não precisa de chave.

Regras

No máximo 60 requisições por minuto por endereço IP; acima disso você recebe HTTP 429 com Retry-After.
O CORS está aberto (Access-Control-Allow-Origin: *), então uma página web pode chamá-lo diretamente.
O status é atualizado a cada 30 segundos e os rankings a cada poucos minutos; não consulte com mais frequência.

Endpoints

GET	Retorna
`/api/v1/status`	Servidor de login e de jogo ligado/desligado, jogadores no jogo, horário do servidor.
`/api/v1/online`	Apenas o número de jogadores no jogo (para o comando /online de um bot).
`/api/v1/rankings/<board>?limit=50`	Melhores personagens, brigadas ou nações (líderes e NCP). Rankings: `level, war, pvp, playtime, brigade, nation`

Exemplo

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

Os erros também são JSON: {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).