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

获取单个服务器状态

GET
/api/servers/status/{server_id}
匿名读取,无请求体。server_id 为必填字符串,精确匹配且不去除首尾空白,未声明长度限制。HTTP 200 返回单个服务器状态,字段与 /api/servers/status/all 的单项一致:server_id、display_name、group_name、last_seen、ttl_seconds、online;last_seen 为 ISO 时间字符串加 Z 或 null,TTL 缺省口径为 20 秒,缺少心跳时 online=false。在线值是心跳时间口径,不是主动连通性检测。未找到时为 404(error 文本为 Not Found),服务异常可能为 500。静态 /api/servers/status/all 优先匹配,不会作为 server_id 查询。只读;未声明固定成功 schema。

请求参数

Path 参数

请求示例代码

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

返回响应

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

示例
null
⚪default
上一页
获取全部服务器状态
下一页
获取动态分类
Built with