跳到正文
浏览文档目录
BUILD WITH A CLEAR BOUNDARY

最小接入:读取服务状态

运行一个无需密钥、不会写入游戏或钱包的 Node.js 示例。

最后核对 中文核实稿 · v0.1
测试中

本地官网可验证 / 公开官网接口已只读探测

1. 下载并运行例子

先按“环境准备”启动本地官网。确认 Node.js 版本不低于 22,再在一个临时目录执行以下命令。下载的是本站公开的完整示例源码,可先打开检查。

PowerShell
node --version
curl.exe --fail -o read-status.mjs http://127.0.0.1:3080/zh-CN/docs-examples/read-status.mjs
node .\read-status.mjs http://127.0.0.1:3080

2. 读懂返回结果

state 为 healthy 表示官网这次配置的上游健康请求获得成功响应;degraded 表示上游失败、超时或不可达。接口 HTTP 200 本身不等于上游健康,需要读 ok 字段。

checkedAt 和 latencyMs 是本次探测时间与耗时。这不是在线人数、世界状态、登录成功率或支付到账的证明。

JSON · 输出结构示意,非实时状态
{
  "endpoint": "http://127.0.0.1:3080/api/game-status",
  "state": "healthy",
  "checkedAt": "<ISO 8601 时间>",
  "latencyMs": 120,
  "scope": "Configured game-health probe only; not a login or payment check."
}

3. 按需读取公开官网

2026-11-02 的只读核对中,公开官网返回了有效的健康摘要。这是一次有时间边界的观察,不保证之后持续可用。请低频读取并缓存展示结果,不要把健康探测当作压力测试。

PowerShell
node .\read-status.mjs https://mir2.obelisk.build

失败时怎样处理

  • 示例限制单次等待时间;网络错误、非成功 HTTP、重定向或响应结构不兼容时,退出码为 1。
  • 合法的 degraded 响应仍是一次成功读取,退出码为 0;界面应显示降级,而非伪造健康。
  • 不要在日志、截图或示例参数中附带密码、访问令牌、助记词或私钥。
文档有误或需要帮助?通过现有支持入口反馈 ↗