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

获取按服务器分组的玩家列表

GET
/api/playerlist/grouped
匿名读取,无请求参数和请求体。HTTP 200 提供 servers、total、lastUpdate;每个服务器分组提供 server、count、players,玩家仅投影 name、uuid、ping,不透传其他字段。缺少服务器名称时归入“未知服务器”,分组按 count 降序、server 字典序排列。name、uuid、ping 未声明固定 JSON 类型,name/uuid 缺省为空字符串,ping 可为 null;延迟值按已提供的候选值回退,部分回退可能忽略 0。total 为合并名单的行数,可能包含重复或占位项,没有新鲜度过滤,不等于实时去重在线人数。lastUpdate 未声明固定类型,可能为时间字符串、null 或原更新时间值。名单不可用时可能为空;其他异常可能为 500,错误分支含空分组、total=0、lastUpdate=null 及 error 文本。只读;不新增固定成功 schema。

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/playerlist/grouped'

返回响应

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

示例
null
⚪default
上一页
获取等级排行榜
下一页
获取玩家名单文本
Built with