开发者
公开 API
所有接口都是只读的 HTTP GET，返回 JSON，无需鉴权。基础地址：/api
使用约定
- 所有接口都是只读的 HTTP GET，返回 JSON（UTF-8），无需鉴权。
- 时间字段统一为 Unix 秒（UTC）。
- 出错时返回 4xx / 5xx，正文为 {"error": "错误码"}。
- 请合理控制频率：服务器状态建议 ≥ 15 秒一次，实时地图 ≥ 5 秒一次。
- 出于安全考虑，任何接口都不返回服务器 IP 和端口。
接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/servers | 所有启用服务器及实时状态 |
| GET | /api/servers/{code}/history?hours= | 在线人数采样（1–336 小时） |
| GET | /api/map?server= | 在线玩家实时位置 |
| GET | /api/stats | 全平台计数统计 |
| GET | /api/users/{id} | 玩家公开主页 |
| GET | /api/news?page=&per=&category= | 新闻列表 |
| GET | /api/news/{id} | 新闻详情 |
| GET | /api/announcements | 全站公告（最多 5 条） |
| GET | /api/events?tab=&page= | 活动列表 |
| GET | /api/events/{id} | 活动详情 |
| GET | /api/vtc?q=&recruiting=&status=&language=&sort=&page= | 车队列表 |
| GET | /api/vtc/{id} | 车队主页 |
| GET | /api/version | 联机组件与支持的游戏版本 |