API 入门

先做只读查询，再按实际能力接入自己的工具。

网页与 API 使用同一个设备后台。先查询真实配置，不从发送成功推断手机执行结果。

服务地址

本机默认 API 地址为 http://127.0.0.1:19310。这里的官网只托管文档，不是设备 API 网关。

curl http://127.0.0.1:19310/healthz
curl http://127.0.0.1:19310/v1/stations
curl http://127.0.0.1:19310/v1/input/status

这些只读查询不发送手机输入。健康接口可能在相机检查异常时返回 503 / degraded；不要把进程存活理解为设备功能全部通过。

多机位路径

从 /v1/stations 读取实际配置的机位，使用返回的机位路径。额外机位采用对应命名空间，例如：

GET /stations/2/v1/input/status
GET /stations/2/v1/frame

机位 2 只是路径格式示例，存在与否取决于你的实际配置。画面接口可能触发采集，不属于单纯的状态枚举。

接入时保留这些判断

• 先确认 provider、deviceId、相机来源和手机永久身份。
• 控制与任务接口遵守现有租约和串行执行规则，不绕过其他操作会话。
• 结果未知时查询原操作，不自动重放可能已经发生的动作。
• 将传输、服务端回执和手机实际效果分别记录。

完整控制参数随实际后台版本变化；请使用对应版本随附的 API 说明。此页提供可直接开始的只读入口。