公開API
Discordボット、ファンサイト、ツール向けの読み取り専用JSON:サーバー状況、オンライン人数、ランキング。キーは不要です。
ルール
- 1つのIPアドレスにつき1分間に最大60リクエストまで。超えると Retry-After 付きの HTTP 429 が返されます。
- CORSは開放されており(Access-Control-Allow-Origin: *)、Webページから直接呼び出せます。
- ステータスは30秒ごと、ランキングは数分ごとに更新されます。それより短い間隔でのリクエストは控えてください。
エンドポイント
| GET | 戻り値 |
|---|---|
/api/v1/status | ログイン/ゲームサーバーの稼働状況、ゲーム内プレイヤー数、サーバー時間。 |
/api/v1/online | ゲーム内のプレイヤー数のみ(ボットの /online コマンド用)。 |
/api/v1/rankings/<board>?limit=50 | 上位キャラクター、ブリゲード、国家(リーダーとNCP)。ランキング:level, war, pvp, playtime, brigade, nation |
例
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}, ...]}
エラーもJSONで返されます:{"error": "unknown_board"} (404)、"unavailable" (503)、"rate_limited" (429)。