Integration between Easy LoRaWAN Cloud and other systems

REST API is used to connect Easy LoRaWAN Cloud and external systems.

• URL: https://ui.easylorawan.com
• API Docs: https://ui.easylorawan.com/swagger-ui/
• Tool to test REST API: https://insomnia.rest/download

Step 1.1: To retrieve tokens using username and password

• Sample request: curl -X POST –header ‘Content-Type: application/json’ –header ‘Accept: application/json’ -d ‘{“username”:”[email protected]“, “password”:”demo-password“}’ ‘https://URL/api/auth/login’
• Sample response: {“token”: “$YOUR_JWT_TOKEN”, “refreshToken”: “$YOUR_JWT_REFRESH_TOKEN”}
• “token” is used in API requests.
• When “token” is expired, “refreshToken” is used to retrieve new “token”
• When “refreshToken” is expired, to run this step again.

Step 1.2: To retrieve device id

• On UI server, to click on a device and copy device id
• The device id is entity id in the next step
• OR you can get the list of devices: /api/customer/{customerId}/devices{?page,pageSize,sortOrder,sortProperty,textSearch,type}

Step 1.3: To retrieve latest sensor data

• API: https://URL/api/plugins/telemetry/{entityType}/{entityId}/values/timeseries{?keys,useStrictDataTypes}
• Sample request: https://URL/api/plugins/telemetry/DEVICE/xxxxxx40-d7f7-11ec-924a-e16522e61bfd/values/timeseries
• Method: GET
• Sample JSON headers: “Accept”: “application/json”, “X-Authorization”: “Bearer  token“. The “token” is from Step 1.
• Sample response: {“RO1_status”: [{“ts”: 1661529134507, “value”: “false”}], “RO2_status”: [{“ts”: 1661529134507, “value”: “false”}]}. “RO1_status” and “RO2_status” are the names of sensor data (e.g.: telemetries). “ts” is timestamp of updated time. “value” is the value of the data in string.