使用 Bruno 完整验证
使用 Bruno 集合验证认证、设备列表、单设备实时状态和可选控制命令。建议在开始编写集成代码前完成这条完整验证路径。
开始前
- 准备
clientId和clientSecret。 - 开启
device:read。 - 只有运行可选继电器命令时才需要
device:control。 - 确认目标设备和继电器可以安全控制。
1. 安装 Bruno
下载 Bruno 桌面应用。CI 或无界面环境可以安装命令行工具：
bash
npm install -g @usebruno/cli
bru --version2. 打开集合
bash
git clone https://github.com/svnwi/wlte-openapi-sdk.git在 Bruno 中打开：
text
examples/bruno/WLTE-OpenAPI/3. 配置环境
打开 environments/quickstart.bru，仅替换：
text
clientId -> your_client_id
clientSecret -> your_client_secret选择 quickstart 环境。集合脚本会自动写入 accessToken、deviceId 和 commandId；relayIndex 默认是 1。
4. 完成只读验证
按顺序运行：
| 顺序 | 请求 | 目的 |
|---|---|---|
| 1 | 00-auth / Auth | 获取 access token |
| 2 | 01-device-queries / 01-list-devices | 确认可访问设备 |
| 3 | 01-device-queries / 02-get-device-real-time-status | 刷新并读取单台设备状态 |
内置断言会校验 HTTP 状态和响应结构。
5. 可选：验证设备控制
设备命令会改变真实硬件。仅在 API Client 具有 device:control 权限且操作安全时继续。
| 顺序 | 请求 | 目的 |
|---|---|---|
| 4 | 02-relay-control / 01-turn-relay-on | 提交继电器命令 |
| 5 | 03-command-result / 01-get-command-result | 查询命令结果 |
只读接入可以跳过此部分。
命令行运行
bash
cd examples/bruno/WLTE-OpenAPI
bru run --env quickstart首次接入建议使用桌面应用，便于查看环境变量、断言和响应内容。
验证结果
完成本页后，已经验证：
- API Client 认证
- 设备访问和列表响应
- 单设备实时状态
- 可选的命令提交和结果查询
不要通过反复查询单台设备来监控整个账号。设备列表用于批量展示，持续变化应使用 WebSocket 事件。