EndlessPixel Wiki

主题

本文共 0 字
预计阅读 1 分钟

EndlessPixel API开放文档 ​

提示

API开放文档是服务器提供的API接口文档，用于开发人员调用服务器的功能和查询服务器的状态。

API接口 ​

查询EndlessPixel服务器在线状态 ​

https://www.epmc.top/api/mcserver/epmc

提示

此接口返回结果与api.mcsrvstat.us相同，请按照api.mcsrvstat.us的解析返回说明文档进行解析，此处不提供解析说明。

愚人节整蛊接口 ​

https://www.epmc.top/api/fool or https://www.epmc.top/api/fool

提示

这是一个纯整蛊娱乐接口，固定返回 HTTP 418 I'm a teapot 状态码，用于愚人节趣味互动，无任何实际业务功能。 每次请求都会随机生成不同文案、心情、错误、推荐仓库，几乎不会重复。

返回示例： ​

请求成功，返回茶壶整蛊数据

1. GET 请求 ​

返回完整整蛊信息 + 随机推荐 7 个 EndlessPixel GitHub 仓库 + 临时随机记录

json
{
  "code": 418,
  "message": "I'm a teapot 🫖 — can't brew coffee, only EndlessPixel's projects!",
  "teapot_mood": "chaotic",
  "fake_error": "TeapotError: Teapot stuck in infinite tea loop 🔁 (April Fools' Fake Error)",
  "april_fools": true,
  "time": "2026-04-10T12:34:56.789Z",
  "teapot_demand": "Buy the teapot a biscuit 🍪",
  "teapot_advice": "If code breaks, blame the teapot — it works every time 😜",
  "fake_api_status": "Prank engine: ONLINE 🤖",
  "fake_support": "Teapot Tech Support: Call ☎️ 1-800-TEAPOT (fake number) — we'll ignore you (April Fools)",
  "prank_emojis": "🫖🥔✨",
  "prank_strength": "78%",
  "tea_level": "63%",
  "ad": {
    "slogan": "Secret Repo Drop: Only teapot insiders get this 🤫",
    "picks": [
      "PotatoMC [April Fools: Minecraft runs on potato + teapot power 🥔🫖]: https://github.com/EndlessPixel/PotatoMC",
      "EP-XPcheckin [April Fools: Checkin gives tea XP instead of points ☕️]: https://github.com/EndlessPixel/EP-XPcheckin",
      "EndlessPixel-Wiki [April Fools: Wiki pages are all tea facts 🫖]: https://github.com/EndlessPixel/EndlessPixel-Wiki",
      "Chat-Box [April Fools: Talks way too much 🗣️]: https://github.com/EndlessPixel/Chat-Box"
    ],
    "prank_disclaimer": "Disclaimer: This teapot is not responsible for any repo pranks (April Fools' Day 2026 🎉)",
    "teapot_rating": "5/5 cups of tea ☕️",
    "april_fools_challenge": "Find all tea emojis in this response 👀",
    "fake_downloads": "12345 (fake) downloads 📥",
    "repo_shuffle_seed": 123456
  },
  "fake_request_id": "TEAPOT-123456-APRILFOOLS-X7Z9",
  "fake_load_time": "2.45s (fake) ⏱️",
  "temp_record": {
    "record_id": "TEMP-8S2KF93Z",
    "record_type": "tea_brewing_record",
    "action": "brewed fresh virtual tea",
    "extra_note": "tea level: 97%",
    "random_seed": 12345678
  }
}
2. POST 请求 ​

在 GET 所有字段基础上，额外增加 POST 专属整蛊字段：

json
{
  // ... 通用字段同上 ...

  "post_prank": "Your POST data was brewed into tea — here's some repos to sip on ☕️",
  "fake_fix": "Solution: Star 5 repos and the teapot will return your data ⭐️",
  "fake_post_processing": "POST data brewed into premium tea 🍵",
  "fake_data_saved": "Data saved to teapot storage (876KB fake) 💾",
  "fake_response_delay": "13ms (we were making tea) ⏳",
  "temp_record": {
    "record_id": "TEMP-7A2DB91C",
    "record_type": "repo_hijack_note",
    "action": "rejected serious API request",
    "extra_note": "mood updated automatically",
    "random_seed": 87654321
  }
}

查询EndlessPixel服务器硬件信息 ​

https://www.epmc.top/api/hardware-info

返回示例： ​

获取硬件时序数据成功

json
{
  "cpu": {
    "model": "Intel(R) Xeon(R) Gold 6148 CPU @ 2.40GHz",  // CPU型号
    "cores": 16,  // 逻辑核心数
    "physical_cores": 16  // 物理核心数
  },
  "memory": {
    "total": 32.0,  // 总内存大小，单位：GB
    "model": "QEMU 定制内存"  // 内存硬件型号
  },
  "disks": [  // 磁盘分区列表
    {
      "device": "C:\\",  // 磁盘设备路径
      "mountpoint": "C:\\",  // 磁盘挂载点
      "fstype": "NTFS",  // .文件系统类型
      "total": 149.46,  // 磁盘总容量，单位：GB
      "used": 20.91,  // 磁盘已使用容量，单位：GB
      "usage_percent": 14.0  // 磁盘使用率，单位：%
    },
    {
      "device": "D:\\",
      "mountpoint": "D:\\",
      "fstype": "NTFS",
      "total": 200.0,
      "used": 45.01,
      "usage_percent": 22.5
    }
  ],
  "gpu": {
    "model": "Unknown",  // GPU型号
    "available": false  // GPU是否可用
  },
  "network": [  // 网络适配器列表
    {
      "name": "物理以太网",
      "addresses": ["内网地址"]
    },
    {
      "name": "虚拟组网网卡",
      "addresses": ["组网地址"]
    },
    {
      "name": "本地回环接口",
      "addresses": ["127.0.0.1"]
    }
  ]
}

查询EndlessPixel服务器硬件实时数据 ​

https://www.epmc.top/api/real-time-data

返回示例： ​

获取服务器硬件实时数据成功

json
{
  // CPU使用率时序数据 [时间戳, 使用率(%)]
  "cpu_usage": [
    [时间戳, 3.9],
    [时间戳, 4.4],
    [时间戳, 5.5],
    // ... 更多历史时序数据
  ],
  // 内存使用率时序数据 [时间戳, 使用率(%)]
  "mem_usage": [
    [时间戳, 93.5],
    [时间戳, 93.5],
    // ...
  ],
  // GPU使用率时序数据 [时间戳, 使用率(%)]
  "gpu_usage": [
    [时间戳, 0],
    [时间戳, 0],
    // ...
  ],
  // 网络上传速度时序 [时间戳, 速度(MB/s)]
  "net_upload_speed": [
    [时间戳, 125.68],
    [时间戳, 142.74],
    // ...
  ],
  // 网络下载速度时序 [时间戳, 速度(MB/s)]
  "net_download_speed": [
    [时间戳, 6.54],
    [时间戳, 6.97],
    // ...
  ],
  // 系统负载时序 [时间戳, 负载值]
  "system_load": [
    [时间戳, 0.0],
    // ...
  ],
  // 进程数量时序 [时间戳, 进程数]
  "process_count": [
    [时间戳, 203],
    // ...
  ],
  // CPU温度时序数据
  "cpu_temperature": [],
  // 各CPU核心实时使用率(%)
  "cpu_core_usage": [
    14.1,52.9,18.8,12.9,9.4,15.3,10.6,4.7,
    // ... 更多核心使用率
  ],
  // 系统启动时间戳
  "boot_time": 时间戳,
  // 电池信息（无则为空）
  "battery_info": {},
  // 当前数据时间戳
  "timestamp": 时间戳
}

查询服务器磁盘占用信息 ​

https://www.epmc.top/api/disk-usage

返回示例： ​

获取磁盘占用数据成功

json
[
  {
    "device": "C:\\",
    "mountpoint": "C:\\",
    "fstype": "NTFS",
    "total": 149.46,
    "used": 20.91,
    "usage_percent": 14.0
  },
  {
    "device": "D:\\",
    "mountpoint": "D:\\",
    "fstype": "NTFS",
    "total": 200.0,
    "used": 45.01,
    "usage_percent": 22.5
  }
]

查询EndlessPixel服务器ping值 ​

https://www.epmc.top/api/ping/epmc

返回示例： ​

Ping 操作成功！返回延迟统计数据。

json
{
  // 平均延迟(ms)
  "avg": 1.25,
  // 目标主机域名
  "host": "cn.bing.com",
  // 目标主机IP地址
  "ip": "142.250.191.78",
  // 服务器位置
  "location": "美国",
  // 最大延迟(ms)
  "max": 2.1,
  // 最小延迟(ms)
  "min": 0.89
}

请求失败，参数无效或目标不可达。前端可直接展示 message 字段。 可能的原因:

  • 无法解析主机: host 参数是一个无效的域名或IP地址。
    json
    {
    "code": "INVALID_PARAMETER",
    "message": "无法解析主机 '无效的主机名'，请检查输入是否正确。"
}
  • Ping 超时: 目标主机无法访问或被防火墙拦截。
    json
    {
 "code": "INVALID_PARAMETER",
 "message": "对主机 '目标主机' 的 Ping 请求超时，目标可能不可达或防火墙已拦截。"
}

服务繁忙。当服务器 Ping 请求过多时，会触发限流。前端可直接展示 message 字段。

json
{
    "code": "SERVICE_BUSY",
    "message": "Ping 服务正忙，请稍后再试。"
}

查询EndlessPixel官方网站状态信息 ​

https://www.epmc.top/api/webstatus

返回示例： ​

检查完成！根据目标URL的可达性返回不同结果。

当目标 URL 可访问时，status 为目标返回的 HTTP 状态码（如 200）。

json
{
  // 目标URL实际返回的HTTP状态码。
  "status": 200,
  "url": "https://www.google.com"
}

当目标 URL 不可达或请求失败（如 DNS 失败、超时、连接失败）时，status 为 0。

json
{
  // 目标不可达或请求失败时固定为 0。
  "status": 0,
  "url": "https://example.invalid"
}

请求参数无效。请检查 url 参数是否提供且格式正确。

json
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing or invalid 'url' parameter."
}

请求URL失败（例如，DNS解析失败、连接超时）。

json
{
  "code": "REQUEST_FAILED",
  "details": {},
  "message": "Failed to request the URL. It might be down or unreachable."
}

查询无尽像素官方 QQ 群的信息 ​

https://www.epmc.top/api/qq/groupinfo

返回示例： ​

成功响应，返回QQ群的详细信息

json
{
  // 群号
  "group_id": "870594910",
  // 群名称
  "group_name": "无尽像素 - EndlessPixel | 1.21.11原版纯净生存 | 冲刺！MC 26.1.2",
  // 群头像URL（标准尺寸100x100）
  "avatar_url": "https://p.qlogo.cn/gh/870594910/870594910/640",
  // 群描述/简介
  "description": "",
  // 群标签
  "tag": "",
  // 加群链接（QR码URL）
  "join_url": "http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=EDJsazmQ6OneCND7g522pbtg1XM1xg8B&authKey=k9ZYDFe%2Fm1WMnbxeydUTL5fSTQkwDjn02xR1ehMB%2F8P7kE8trc%2Bnex97zJ9G2w1T&noverify=0&group_code=870594910",
  // 最后更新时间（ISO 8601格式）
  "last_updated": "2026-04-09T19:08:41.992441324+08:00",
  // 当前成员数
  "member_count": 263,
  // 最大成员数
  "max_member_count": 500,
  // 活跃成员数（可选，部分群有此数据）
  "active_member_num": null,
  // 群主QQ号（可选）
  "owner_uin": "3785267350",
  // 群主UID（可选）
  "owner_uid": "u_6B016teRQPoIo-AkOCezkQ",
  // 建群时间戳（Unix时间戳，可选）
  "create_time": 1726422752,
  // 建群时间格式化字符串（可选）
  "create_time_str": "2024-09-16 01:52:32",
  // 群等级（可选）
  "group_grade": 3,
  // 群公告/简介（可选）
  "group_memo": "",
  // 认证类型（0=未认证，可选）
  "cert_type": 0,
  // 认证说明文本（可选）
  "cert_text": ""
}

查询EndlessPixel服务器玩家游戏截图列表 ​

https://www.epmc.top/api/player/screenshot/list

获取 EndlessPixel 服务器全部玩家游戏截图元数据列表，包含图片地址、上传玩家、时间、分辨率、大小、SHA256 校验值等完整信息。

返回示例： ​

成功响应，返回截图数组

json
[
  {
    // 截图文件路径
    "path": "assets/huge_2026-02-17_16.34.17.png",
    // 上传玩家游戏名称
    "player": "system_mini",
    // 截图拍摄时间（标准日期格式）
    "date": "2026-02-17 16:34:17",
    // 图片分辨率
    "resolution": "3840x2160",
    // 图片文件大小
    "size": "18.0MB",
    // 文件 SHA256 哈希校验值
    "sha256": "6F2CDF5A52D3152551CC1553E904C443CA3457C1D05E8ACF9FAFA55654E49CAD"
  }
]

"Minecraft" 和 "我的世界" 是 Mojang AB 的注册商标。本站与 Mojang 或 Microsoft 无任何关联。

Copyright © 2024-2026 EndlessPixel Studio