API publique

JSON en lecture seule pour les bots Discord, sites de fans et outils : état du serveur, joueurs en ligne et classements. Aucune clé requise.

Règles

Au maximum 60 requêtes par minute et par adresse IP ; au-delà, tu reçois HTTP 429 avec Retry-After.
CORS est ouvert (Access-Control-Allow-Origin: *), une page web peut donc l'appeler directement.
Le statut est actualisé toutes les 30 secondes, les classements toutes les quelques minutes ; n'interroge pas plus souvent.

Endpoints

GET	Renvoie
`/api/v1/status`	Serveurs de connexion et de jeu en/hors ligne, joueurs en jeu, heure du serveur.
`/api/v1/online`	Uniquement le nombre de joueurs en jeu (pour la commande /online d'un bot).
`/api/v1/rankings/<board>?limit=50`	Meilleurs personnages, brigades ou nations (chefs et NCP). Classements : `level, war, pvp, playtime, brigade, nation`

Exemple

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

Les erreurs sont aussi en JSON : {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).