游戏

查询 MC 基岩版服务器

0次调用
1 积分/次

想实时监控 Minecraft 基岩版(Bedrock Edition)服务器的状态吗?由于基岩版采用了与 Java 版完全不同的底层网络通信协议(RakNet),这与 Java 版的查询截然不同。这个接口专门为您解决基岩版服务器的测速与监控需求。

GET
uapis.cn
/api/v1/game/minecraft/bedrockstatus
查询参数
1
server
string
required

基岩版服务器的地址,支持域名或 IP:端口 的格式。若省略端口,则默认使用基岩版的标准端口 19132。

功能概述

只需提供基岩版服务器地址(域名或 IP),即可实时获取其在线状态。除了常规的在线人数、最大人数、协议版本外,还会返回基岩版特有的双行 MOTD(主标题与副标题)、游戏模式(如 Survival)以及服务端唯一的 GUID

离线与缺省字段处理 当目标服务器离线或无法连通时,响应体中仅会返回 online: false,其余字段均会被自动省略。请务必在前端代码中做好对应字段的判空处理。

延迟与测速 响应中的 latency_ms 代表的是云端接口服务器到目标服务器的网络测速耗时,该数值仅供参考,并不代表最终用户直连该服务器时的真实游戏延迟。

查询参数

server
string必填

基岩版服务器的地址,支持域名或 IP:端口 的格式。若省略端口,则默认使用基岩版的标准端口 19132。

响应

200 / 请求成功

查询成功!返回基岩版服务器的详细状态信息。如果服务器处于离线状态,将仅返回 { "online": false }。

JSON
{
  // 服务器当前是否在线。为 false 时其余字段均不会被返回。
  "online": true,
  // 服务器域名解析后的 IP 地址。
  "ip": "139.99.123.79",
  // 实际查询的基岩版端口。
  "port": 19132,
  // 服务端类型标识,MCPE 代表基岩版,MCEE 代表教育版。
  "edition": "MCPE",
  // 服务端上报的版本字符串。注意:部分服务器可能会将此字段修改为任意的广告文本。
  "version": "1.26.44",
  // 基岩版底层的网络协议版本号。
  "protocol": 2168,
  // 当前在线的玩家数量。
  "players": 5059,
  // 服务器配置的最大玩家容量(大型服务器常伪造此数值以显示热度)。
  "max_players": 15059,
  // 第一行 MOTD 的 HTML 渲染格式,内置的颜色码已被转为内联样式,可直接在前端渲染展示。
  "motd_html": "🌧 SKYBLOCK & ONEBLOCK ⛈",
  // 第一行 MOTD 的纯文本格式。
  "motd_clean": "🌧 SKYBLOCK & ONEBLOCK ⛈",
  // 基岩版特有的第二行 MOTD 的 HTML 渲染格式(部分服务器此字段可能为空)。
  "sub_motd_html": "C",
  // 第二行 MOTD 的纯文本格式。
  "sub_motd_clean": "C",
  // 服务器的默认游戏模式。
  "gamemode": "Survival",
  // 服务端唯一的 GUID(以字符串格式返回,防止 JavaScript 大整数精度丢失)。
  "server_guid": "12484560144851717283",
  // 服务端广播的 IPv4 端口(部分服务器可能不返回此字段)。
  "port_v4": 19132,
  // 服务端广播的 IPv6 端口(部分服务器可能不返回此字段)。
  "port_v6": 19132,
  // 云端接口服务器到目标服务器的网络测速耗时(毫秒)。
  "latency_ms": 238
}

400 / 错误的请求

请求参数无效或地址无法被解析。

JSON
{
  "code": "INVALID_PARAMETER",
  "message": "目标地址不允许查询"
}

500 / 服务器内部错误

服务器内部错误,查询服务暂时不可用。

JSON
{
  "code": "INTERNAL_ERROR",
  "message": "游戏服务查询失败"
}