游戏

查询Minecraft服务器状态

0次调用

想在加入服务器前看看有多少人在线?或者检查一下服务器开没开?用这个接口就对了!

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

Minecraft服务器的地址,可以是域名(如 hypixel.net)或 IP:端口 的形式(如 mc.example.com:25565)。如果省略端口,将默认使用 25565

功能概述

你可以通过提供服务器地址(域名或IP),来获取一个 Minecraft Java 版服务器的实时状态。返回信息非常丰富,包括服务器是否在线、当前玩家数、最大玩家数、服务器版本、MOTD(每日消息)以及服务器图标等。

查询参数

server
string
required

Minecraft服务器的地址,可以是域名(如 hypixel.net)或 IP:端口 的形式(如 mc.example.com:25565)。如果省略端口,将默认使用 25565

响应

200 / 请求成功

查询成功!返回服务器的详细状态信息。

400 / 错误的请求

请求失败。请检查你是否提供了 server 参数。

404 / 未找到

服务器未找到。这可能意味着你提供的服务器地址无法解析,或者服务器当前处于离线状态。

502 / 网关错误

查询失败。在尝试连接并获取服务器信息时发生网络错误或协议错误。