接口简介：
查询指定Minecraft(我的世界)服务器的各类信息，接口盒子优化多协议查询，成功率高，信息全。
请求地址：
https://cn.apihz.cn/api/fun/mcserver.php
请求方式：
POST或GET。
请求参数：
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】
【服务器地址】【host】【是】【要查询的服务器地址，可以是域名，也可以是ip地址。例：host=mc2.rhymc.com】
【端口】【port】【否】【服务器端口，默认25565。例：port=25565】
【查询协议】【xy】【否】【0=自动协议 1=现代协议 2旧版协议 3=UDP协议 4=兼容协议。默认0，自动尝试查询协议。如果多次查询失败，可指定查询协议，每种查询协议均可多次尝试，并非百分百查询成功。如果对方服务器禁止查询则无论使用何种协议均会查询失败。例：xy=0】
返回参数：
【名称】【参数】【说明】
【状态码】【code】【200成功，400错误，可尝试切换各种查询协议，并多次尝试，查询成功后的结果会有1分钟缓存时间。各协议，各版本尝试查询时间为2秒，超过2秒均视为失败。】
【信息提示】【msg】【返回提示。】
【服务器地址】【address】【服务器IP归属地。】
【结果集】【data】【查询结果集。】
【服务器IP地址】【data.hostname】【服务器IP地址。】
【服务器端口号】【data.port】【服务器端口号。】
【查询状态】【data.status】【true成功，false失败。】
【版本号】【data.version】【Minecraft服务器的软件版本号（如 1.20.1）。】
【网络协议版本号】【data.protocol】【与服务器版本对应的网络协议版本号。】
【标题】【data.server_title】【服务器标题，由接口自动截取描述，仅供参考。】
【在线玩家数】【data.players】【当前在线玩家数量。】
【最大玩家数量】【data.max_players】【服务器允许的最大玩家数量，该值为服务器管理设定，仅做为参考。】
【服务器描述】【data.motd】【清理掉颜色代码后的服务器描述信息（MOTD）。】
【服务器原始描述】【data.motd_raw】【原始的、包含颜色格式代码的服务器描述信息。】
【服务器图标】【data.favicon】【服务器图标，BASE64编码。】
【模组列表】【data.mods】【模组列表。】
【核心类型】【data.software】【服务器核心类型（如 Vanilla, Paper, Spigot, Forge, Fabric等）。】
【插件列表】【data.plugins】【服务器安装的插件列表（包含name和version）。】
【网络延迟】【data.ping】【连接到服务器的网络延迟（毫秒），以本接口服务器所在地连接服务器时间，一般为上海。该延迟为单次ping测，仅供参考。如果要测试其他地区链接延迟，可调用接口盒子ping接口。】
【查询协议】【data.query_method】【查询使用的协议（现代协议/旧版协议/UDP查询/MCStatus兼容）。】
【错误信息】【data.error】【查询失败的错误描述。】
【示例玩家列表】【data.players_sample】【部分玩家的列表，由服务器提供的自定义列表，可能非实际列表，可由管理人员自定义。】
【地图名称】【data.map】【服务器当前运行的地图名称。】
【游戏模式】【data.game_mode】【服务器默认的游戏模式。】
【结构化详细信息】【data.description】【MOTD的结构化详细信息，通常包含text和extra数组且格式不固定，仅供参考。】
【查询输出日志】【data.debug_log】【详细列出本次查询流程日志。】
GET请求示例：
https://cn.apihz.cn/api/fun/mcserver.php?id=88888888&key=88888888&host=mc2.rhymc.com&port=26549&xy=0
注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。
POST请求示例：
请根据开发语言自行POST。
返回数据示例：
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"address": "亚洲-中国-江苏省-镇江市-润州区-BGP",
"msg": "查询成功",
"data": {
"hostname": "43.248.139.152",
"port": 26549,
"status": true,
"version": "Spigot 1.12.2",
"protocol": 340,
"server_title": "加入本服",
"players": 9,
"max_players": 2025,
"motd": "世纪监狱 加入本服 共度未来 感谢游玩本服务器",
"motd_raw": "§c§l世纪§3§l监狱 §8加入本服 共度未来 感谢游玩本服务器",
"favicon": "",
"mods": [],
"software": "Spigot",
"plugins": [],
"ping": 212,
"query_method": "现代协议",
"error": "",
"players_sample": [{
"name": "§b状态:正常",
"id": "2730fa19-39ec-3df4-b011-b1547433df9a"
}, {
"name": "§a时间：22:07:11",
"id": "37d99c2d-51cb-3f66-a0f1-515dc329a2a3"
}, {
"name": "§b地理位置：获取失败",
"id": "679820ae-456b-39b4-aa5c-08ef3ad3b880"
}, {
"name": "§e当前人数：9",
"id": "488fd4bc-2b2e-342a-b802-dc54577f9749"
}, {
"name": "§c最大人数：2025",
"id": "3f73d801-b45c-3c32-9687-501a0effc791"
}],
"map": "未知",
"game_mode": "未知",
"description": {
"text": "§c§l世纪§3§l监狱 §8加入本服 共度未来 感谢游玩本服务器"
},
"debug_log": [
"2025-08-30 22:14:20 - 使用自动协议检测",
"2025-08-30 22:14:20 - 尝试现代协议查询...",
"2025-08-30 22:14:20 - 开始协议版本检测: 43.248.139.152:26549",
"2025-08-30 22:14:20 - 检测到协议版本: 340"]
}
}
参考资料(版权)：
https://www.apihz.cn/api/funmcserver.html
