Minecraft（我的世界）服务器信息查询免费API接口详解

json复制{
  "code": 200,                     // 状态码（200成功/400错误）
  "msg": "查询成功",               // 操作提示
  "address": "亚洲-中国-江苏省",   // IP归属地
  "data": {
    "hostname": "43.248.139.152",   // 服务器IP
    "port": 26549,                  // 服务器端口
    "status": true,                 // 查询状态
    "version": "Spigot 1.12.2",     // 服务器版本
    "protocol": 340,                // 网络协议版本
    "players": 9,                   // 在线玩家数
    "max_players": 2025,            // 最大玩家数
    "motd": "世纪监狱服务器",       // 清理后的描述
    "motd_raw": "§c§l世纪§3§l监狱", // 原始带格式描述
    "favicon": "BASE64_DATA",       // 服务器图标
    "ping": 212,                    // 网络延迟(ms)
    "query_method": "现代协议",     // 使用的协议
    "players_sample": [{            // 示例玩家列表
      "name": "§b状态:正常", 
      "id": "2730fa19-39ec-3df4"
    }],
    "map": "未知",                  // 地图名称
    "game_mode": "未知"             // 游戏模式
  }
}

php复制<?php
$api_url = "https://cn.apihz.cn/api/fun/mcserver.php";
$params = [
    'id'    => 'YOUR_USER_ID',      // 替换为实际ID
    'key'   => 'YOUR_API_KEY',      // 替换为实际KEY
    'host'  => 'mc.hypixel.net',    // 目标服务器
    'port'  => 25565,               // 服务器端口
    'xy'    => 0                    // 自动协议
];

// 构建请求URL
$request_url = $api_url . '?' . http_build_query($params);

// 发送GET请求
$response = file_get_contents($request_url);

// 解析结果
$result = json_decode($response, true);
if ($result['code'] == 200) {
    echo "服务器版本: " . $result['data']['version'] . "\n";
    echo "在线玩家: " . $result['data']['players'] . "/" . $result['data']['max_players'];
} else {
    echo "查询失败: " . $result['msg'];
}
?>

python运行复制import requests

api_url = "https://cn.apihz.cn/api/fun/mcserver.php"
params = {
    "id": "YOUR_USER_ID",       # 替换为实际ID
    "key": "YOUR_API_KEY",      # 替换为实际KEY
    "host": "mc.hypixel.net",   # 目标服务器
    "port": 25565,              # 服务器端口
    "xy": 0                     # 自动协议
}

try:
    # 发送GET请求
    response = requests.get(api_url, params=params)
    data = response.json()
    
    if data["code"] == 200:
        print(f"服务器状态: {data['data']['status']}")
        print(f"MOTD描述: {data['data']['motd']}")
        print(f"网络延迟: {data['data']['ping']}ms")
    else:
        print(f"错误: {data['msg']}")
        
except Exception as e:
    print(f"请求异常: {str(e)}")