游戏

查询 MC 服务器

0次调用
1 积分/次

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

功能概述

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

如果服务器返回当前在线玩家列表,响应里还会带上 online_players 字段。这个字段可能省略,部分服务器返回的列表也可能不完整。

查询参数

server
string必填

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

响应

200 / 请求成功

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

JSON

400 / 错误的请求

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

JSON

404 / 未找到

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

JSON

502 / 网关错误

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

JSON