接口线路类型一[集群IP接口-免费]
[接口地址1]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
：当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]
[接口地址]
：[自动分发到集群接口服务器，但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口]
：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！CC防火墙宽松。登录后购买。]
复制
测速
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。
提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者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 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | 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 | 详细列出本次查询流程日志。 |
返回数据示例
示例：{"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"]
}
}
更新记录
2025-08-30 22:01:49 - 新增接口。
视听娱乐-Minecraft(我的世界)服务器信息查询-2025-08-30 22:39:51
