1. 游戏排行榜
KukeMC-群组服 API 文档
  • KukeMC 公共 API 接入指南
  • 公开接口文档
    • 状态与监测
      • 获取 API 状态
      • 获取全部服务器状态
      • 获取单个服务器状态
    • 内容与分类
      • 获取动态分类
      • 获取公开新闻列表
      • 获取公开更新日志
    • 公开表单
      • 获取公开表单列表
      • 获取公开表单详情
    • 游戏排行榜
      • 获取 KitBattle 排行榜
        GET
      • 获取等级排行榜
        GET
    • 在线玩家
      • 获取按服务器分组的玩家列表
      • 获取玩家名单文本
    • 玩家认证
      • 获取玩家公开认证状态
  • 数据模型
    • PublicForm
    • PublicNews
    • PublicChangelog
  1. 游戏排行榜

获取 KitBattle 排行榜

GET
/api/server/kitbattle/leaderboard/{type}
匿名读取,无请求体。type 必填,仅接受 kills、deaths、exp、coins、kd;其他值为 400(Invalid leaderboard type)。period 默认 total,仅 weekly、monthly 使用周期统计,其他字符串按累计统计;page 默认 1,服务端将小于 1 的值调整为 1;limit 默认 10,服务端调整到 1~50。search 可省略或为 null,非空值按玩家名进行包含匹配,不去除首尾空白。HTTP 200 含 data 列表及 pagination,分页信息含 total、page、limit、total_pages;榜单项含 name、value、rank、exp、kills、deaths、coins、kd、position。value 为所选指标,kd 为小数,其他指标为整数;其余统计字段仍为累计值,kd 字段也为累计 KD。周期值为累计值减周期起点,仅纳入当前周期匹配者,负增量不截断;KD 分母为零时取击杀数或周期击杀增量。按 value 降序,并列无固定次级顺序;不搜索时 position 为当前分页位置,搜索时尝试全局名次并可能回退列表位置。周期依服务端本地日期,未承诺统一结果快照。只读;整数类型错误通常为 422,服务或数值处理异常可能为 500。未声明固定响应模型,不新增结构化成功 schema。

请求参数

Path 参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/server/kitbattle/leaderboard/kills?period=total&page=1&limit=10&search=PLAYER_NAME_PLACEHOLDER'

返回响应

🟢200
application/json
HTTP 200;未声明固定响应模型,自由 schema 不代表任意推测的成功结构。
Bodyapplication/json

示例
null
⚪default
上一页
获取公开表单详情
下一页
获取等级排行榜
Built with