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. 调用 查询设备列表 获取可访问设备和 deviceId。
4. 如需按设备类型渲染 UI，可调用 查询设备类型定义列表。
5. 如需读取点动时长、RS485 波特率等已缓存配置，可调用 查询设备配置。
6. 根据设备能力调用继电器控制、RS485 透传或 RS485 配置等设备操作接口。
7. 如首次响应未返回最终结果，调用 查询命令结果 查询设备执行结果。

端点汇总

方法	路径	说明	Scope
POST	/wlte/v1/auth/token	创建访问令牌	—
GET	/wlte/v1/devices	查询设备列表	device:read
GET	/wlte/v1/devices/{deviceId}	查询设备详情	device:read
GET	/wlte/v1/devices/{deviceId}/config	查询设备配置	device:read
GET	/wlte/v1/device-profiles	查询设备类型定义列表	device:read
POST	/wlte/v1/devices/{deviceId}/relays/{index}/commands	控制设备继电器	device:control
POST	/wlte/v1/devices/{deviceId}/rs485/transceive	RS485 透传命令	device:control
PUT	/wlte/v1/devices/{deviceId}/rs485/baud-rate	设置 RS485 波特率	device:config
GET	/wlte/v1/commands/{commandId}	查询命令结果	device:read

推荐阅读顺序

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

参考

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