REST API

The WLTE REST API provides device queries, device type definitions, device control, and command result lookup over standard HTTP with Bearer Token authentication.

Service Address

https://openapi.svnwi.com

{baseUrl} throughout this documentation refers to this address. Example full request URL:

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

Integration Flow

1. Call Create Access Token to obtain accessToken.
2. Use Authorization: Bearer {accessToken} to call device APIs.
3. Call List Devices to get accessible devices and deviceId values.
4. If your UI depends on device type capabilities, call List Device Type Definitions.
5. If you need cached configuration such as relay jog duration or RS485 baud rate, call Get Device Configuration.
6. Based on device capabilities, call relay control, RS485 transceive, or RS485 configuration endpoints.
7. If the initial response does not return a final result, call Get Command Result.

Endpoint Summary

Method	Path	Description	Scope
POST	/wlte/v1/auth/token	Create access token	—
GET	/wlte/v1/devices	List devices	device:read
GET	/wlte/v1/devices/{deviceId}	Get device detail	device:read
GET	/wlte/v1/devices/{deviceId}/config	Get device configuration	device:read
GET	/wlte/v1/device-profiles	List device type definitions	device:read
POST	/wlte/v1/devices/{deviceId}/relays/commands	Control one or multiple relays	device:control
POST	/wlte/v1/devices/{deviceId}/relays/{index}/commands	Control one relay (compatibility endpoint, planned for removal)	device:control
POST	/wlte/v1/devices/{deviceId}/rs485/transceive	RS485 transceive command	device:control
PUT	/wlte/v1/devices/{deviceId}/rs485/baud-rate	Set RS485 baud rate	device:config
PUT	/wlte/v1/devices/{deviceId}/relays/{index}/jog-config	Set relay jog duration	device:config
GET	/wlte/v1/commands/{commandId}	Get command result	device:read

Recommended Reading Order

1. Response Envelope
2. Base URL and Headers
3. Permissions
4. Pagination
5. Rate Limits and Retries
6. Create Access Token
7. List Devices
8. Get Device
9. Get Device Configuration
10. List Device Type Definitions
11. Create Relay Command
12. Control One Relay (Planned for Removal)
13. RS485 Transceive
14. Set RS485 Baud Rate
15. Set Relay Jog Duration
16. Get Command Result
17. Status Code Overview

Reference

• Peripheral State Reference — field definitions for relays, digital inputs, sensors, and analog inputs