API Try-it 指南
API 参考的各产品页面均随附 Playground(Try-it) 控制台。您可以在浏览器中直接调用设备的 REST API 并查看响应；每个操作还配有 copy-as-curl(复制 cURL 命令)按钮，因此在难以直接调用的环境中也可以在终端中执行相同的请求。
1. 输入设备地址
请在 Playground 顶部的服务器变量 device_ip 中输入目标设备的 IP(例如 192.168.0.30)。由于 API 由设备直接提供服务，该地址必须是在同一网络(或 P2P 直连)内可访问的地址。
2. 浏览器支持
| 浏览器 | 浏览器直接调用 | 条件 |
|---|---|---|
| Chrome / Edge 142+ | 支持 | 针对私有 IP 首次允许本地网络访问(LNA)权限之后 |
| Firefox 149/151+ | 大体支持 | 采用相同的 LNA 模型，正在逐步推出 |
| Safari | 不支持 | 私有网络 mixed content 被阻止 — 请使用 copy-as-curl |
💡 参考： 本文档站点为 HTTPS，而设备 API 为私有网络的 HTTP。Chrome/Edge 142+ 对以私有 IP 字面量为目标的请求自动豁免 mixed content，并在首次弹出本地网络访问(LNA)权限提示。允许后即可正常调用。
3. 直接调用被阻止时 — copy-as-curl 回退方案
如果使用 Safari 或旧版浏览器，或者包含认证(Basic Auth)的跨源请求被浏览器策略阻止，请通过各操作的 copy-as-curl 按钮复制 cURL 命令，并在终端中执行。该方式在所有浏览器和环境中的行为完全相同。
curl -u admin:<password> http://192.168.0.30/setting/status4. 故障排查
-
如果 LNA 提示未弹出或已被拒绝 → 请在浏览器的站点权限中允许本地网络访问。
-
Safari 会阻止私有网络的 mixed content，因此无法直接调用 → 请使用 copy-as-curl。
-
对于需要认证的请求，请输入用户名和密码。设备的默认账户必须在首次接入时进行更改。