REST API

WLTE REST API 提供设备查询、继电器控制和命令结果查询能力，基于标准 HTTP 协议，使用 Bearer Token 认证。

服务地址

https://openapi.svnwi.com

文档中的 {baseUrl} 均指此地址。完整请求地址示例：

https://openapi.svnwi.com/wlte/v1/devices

接入流程

1. 调用 创建访问令牌 获取 accessToken。
2. 使用 Authorization: Bearer {accessToken} 调用设备接口。
3. 调用 查询设备列表 获取可访问设备。
4. 如需了解设备类型的 IO 定义，可调用 查询设备类型定义列表。
5. 调用 控制设备继电器 发送控制命令。
6. 调用 查询命令结果 查询设备执行结果。

端点汇总

方法	路径	说明	Scope
POST	/wlte/v1/auth/token	创建访问令牌	—
GET	/wlte/v1/devices	查询设备列表	device:read
GET	/wlte/v1/devices/{deviceId}	查询设备详情	device:read
GET	/wlte/v1/device-profiles	查询设备类型定义列表	device:read
POST	/wlte/v1/devices/{deviceId}/relays/{index}/commands	控制设备继电器	device:control
GET	/wlte/v1/commands/{commandId}	查询命令结果	device:control

推荐阅读顺序

1. 响应格式
2. 服务地址与请求头
3. 权限范围
4. 分页规则
5. 限流与重试
6. 创建访问令牌
7. 查询设备列表
8. 查询设备详情
9. 查询设备类型定义列表
10. 控制设备继电器
11. 查询命令结果
12. 状态码总览

参考

• 外设状态说明 — 继电器、数字输入、传感器、模拟量的字段定义