Minecraft 服务器查询

接口说明

查询 Minecraft 服务器实时状态，支持 Java 版与基岩版。供玩家或管理工具快速获取服务器在线人数、版本、延迟等基础信息，免费使用。

调用地址

https://api.xunjinlu.fun/apis/mccx

请求方式

GET

鉴权说明

本接口无需密钥即可调用。

请求参数

参数取值说明：

• useSRV：当服务器域名配置了 SRV 记录且需要自动解析时设为 true，否则可省略。
• host：支持 IP 地址或域名；若端口非默认，请以 地址:端口 格式传入。
• type：java 对应 Java 版服务器，bedrock 对应基岩版服务器。

成功响应示例

{
  "msg": "success",
  "serv_ver": "1.8.x-1.20.x",
  "serv_name": "Hypixel Network",
  "onl_l": 45000,
  "max_l": 200000,
  "serv_ping": 25,
  "serv_ico": null
}

响应字段说明

错误响应示例

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

业务错误码说明

调用示例

终端 curl（bash）

curl -G "https://api.xunjinlu.fun/apis/mccx" \
  --data-urlencode "host=mc.example.com:25565" \
  --data-urlencode "type=java" \
  --data-urlencode "useSRV=false"

PHP

注意事项

• 本接口免费且无需密钥，但属于公共资源，请勿将接口地址转售或用于非个人合理使用的高频调用。
• 频率限制约为每分钟 30 次，超出限制可能被临时限流，请避免循环请求或高并发访问。
• 请始终使用 HTTPS 调用本接口，确保请求参数在传输过程中不被明文窃取。
• 参数 type 必填，仅接受小写 java 或 bedrock，其他值会导致查询失败。
• 参数 host 必填，可填写域名或 IP，若需指定端口请使用 mc.example.com:25565 格式。
• 参数 useSRV 为可选参数，仅在传入字符串 "true" 时启用 SRV 记录解析，未传时等效于 "false"。
• 返回字段 serv_ico 可能为 null，表示服务器未提供图标，属于正常情况。