Herkese açık API
Discord botları, hayran siteleri ve araçlar için salt-okunur JSON: sunucu durumu, online oyuncu ve sıralamalar. Anahtar gerekmez.
Kurallar
- IP adresi başına dakikada en fazla 60 istek; fazlasında Retry-After ile HTTP 429 döner.
- CORS açık (Access-Control-Allow-Origin: *); bir web sayfası doğrudan çağırabilir.
- Durum 30 saniyede, sıralamalar birkaç dakikada bir yenilenir; daha sık sorgulamayın.
Uç noktalar
| GET | Döndürdüğü |
|---|---|
/api/v1/status | Giriş ve oyun sunucusu açık/kapalı, oyundaki oyuncu, sunucu saati. |
/api/v1/online | Sadece oyundaki oyuncu sayısı (bir botun /online komutu için). |
/api/v1/rankings/<board>?limit=50 | İlk karakterler, brigade'ler ya da uluslar (liderler ve NCP). Tablolar:level, war, pvp, playtime, brigade, nation |
Örnek
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}, ...]}Hatalar da JSON'dur: {"error": "unknown_board"} (404), "unavailable" (503), "rate_limited" (429).