接口文档
为开发者提供稳定、高效的 Minecraft 服务器数据接口服务
使用声明
本平台接口完全免费开放。严禁用于商业牟利、恶意高频请求或爬虫攻击。使用数据时请注明来源“浆果服-MCMSF”。
服务器列表查询
GETPOST
获取服务器列表数据，支持分页查询。隐藏地址的服务器将返回脱敏后的提示文本。
接口地址
/api/servers.php?action=list
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | int | 否 | 页码，默认 1 |
| size | int | 否 | 每页数量，默认 10，最大 100 |
| sort | string | 否 | 排序：time(时间), random(随机) |
实时状态查询
GET获取指定服务器的实时在线人数、MOTD、Ping 延迟及图标。离线服务器 ping 返回 null。
接口地址
/api/servers.php?action=status
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 服务器唯一 ID |
24h 在线统计历史
GET获取指定服务器近 24 小时的人数变化历史数据（每 15 分钟一个采样点）。
接口地址
/api/server_stats.php?action=history
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| server_id | int | 是 | 服务器唯一 ID |