GET /api/health

调用前先探一下：盒子服务在不在？ 避免盒子没启动时请求失败。

检测盒子的本地 HTTP 服务是否正常运行。

脚本如果需要调用其他接口，可以先探一下这个地址，避免盒子没启动时请求失败。

---

请求

curl http://127.0.0.1:9527/api/health

---

响应

{"status": "healthy", "service": "BmScriptsBox"}

---

在脚本中使用

import sys, json, requests

payload = json.load(open(sys.argv[1], encoding='utf-8'))
api_base = payload["environment"]["api_base"]

try:
    requests.get(f"{api_base}/api/health", timeout=3)
except requests.RequestException:
    print("盒子服务未启动，无法调用联动接口")
    sys.exit(1)

---

相关文档

• 参数传递机制 → 参数传递机制
• HTTP API 总览 → HTTP API