Devices
User devices API
These routes provide access to a user’s devices, supporting POST and DELETE methods for individual devices. They return detailed information including device properties.
GET /user/device
This route fetches the list of the all devices associated with the account.
- Example response:
{
"errors": [],
"debug": [],
"meta": [],
"data": [
"1a2b3c4d5e6f0000",
"1a2b3c4d5e6f0001",
"1a2b3c4d5e6f0002",
"1a2b3c4d5e6f0003",
"1a2b3c4d5e6f0006",
"1a2b3c4d5e6f0007",
"1a2b3c4d5e6f0008",
"1a2b3c4d5e6f0009",
"9f8e7d6c5b4a3210",
"abcdabcdabcdabcd",
"0019c30000021132",
"0019c30000021613",
"0019c3000002362a",
"0019c30000026595",
"0019c30000026e93",
"0019c30000026ea1",
"0019c30000027731",
"0051d3fffe991953",
"0051d3fffe992b5b",
"0051d3fffe993e36",
"0051d3fffe995040",
"0051d3fffe996473",
"0051d3fffe99acc9"
],
"success": true
}
GET /user/device/autocomplete
This route retrieves a list of devices associated with the current user, filtered based on a partial search query. It is typically used to provide autocomplete suggestions when typing a device name, ID, or other identifying information in a search or selection field.
- Example response:
{
"errors": [],
"debug": [],
"meta": [],
"data": [
"a1b2c3d4e5f60001",
"b3c4d5e6f7a80002",
"c5d6e7f8a9b10003",
"d7e8f9a0b1c20004",
"e9f0a1b2c3d40005",
"f1a2b3c4d5e60006",
"a3b4c5d6e7f80007",
"b5c6d7e8f9a90008",
"c7d8e9f0a1b20009",
"d9e0f1a2b3c4000a"
],
"success": true
}
POST /user/device/{eui}
This route allows a user to register a new device by providing its EUI through the API. It adds the device to the user’s account and enables subsequent management via the system.
DELETE /user/device/{eui}
This route allows users to delete a device from their IoT Wonderland account via the API.
GET /user/device/table/{eui}
This route retrieves a detailed table of properties for a specific device. It includes uplink data, decoded payloads, timestamps, geolocation, battery, firmware, and sensor readings.
- Example response:
{
"errors" : [],
"debug": [],
"meta": [],
"data": [
{
"uplink": {
"uid": 44533033,
"time_stamp_unix": 1751126960,
"devEUI": "5A9F1B7D2C8E4F31",
"port": 100,
"SF": 12,
"RSSI": -77,
"payload_raw": "vAu8AdBFAQ==",
"network": "Swisscom",
"geoloc_lat": 0,
"geoloc_lon": 0,
"geoloc_alt": 0,
"SNR": 9.25,
"api_ref": 3,
"user_ref": 55,
"device_ref": 6336
},
"ts_network_unix": 1751126960,
"ts_net_unix": 1751126960,
"payload_port": 100,
"payload_length": 7,
"payload_hex": "a19f2e03c567ab",
"payload_valid": true,
"payload_decoded": {
"firmware_version": "1.0.d045",
"fw_maj": "1",
"fw_min": "0",
"fw_build": "d045",
"valid_datetime": false,
"valid_status": true,
"valid_gps": false,
"valid_aux": false,
"valid": true
},
"ts_gps_unix": null,
"LAT": null,
"LON": null,
"ALT": null,
"geoloc_LAT": null,
"geoloc_LON": null,
"geoloc_ALT": null,
"temperature": null,
"humidity": null,
"battery_voltage": null,
"battery_percent": null,
"firmware_version": "1.0.d045"
},
{
"uplink": {
"uid": 44533040,
"time_stamp_unix": 1751126964,
"devEUI": "5A9F1B7D2C8E4F31",
"port": 110,
"SF": 12,
"RSSI": -75,
"payload_raw": "////uQAAAAcNtwAADIAAOlBxWQAUAAAAAAM=",
"network": "Swisscom",
"geoloc_lat": 0,
"geoloc_lon": 0,
"geoloc_alt": 0,
"SNR": 10.5,
"api_ref": 3,
"user_ref": 55,
"device_ref": 6336
},
"ts_network_unix": 1751126964,
"ts_net_unix": 1751126964,
"payload_port": 110,
"payload_length": 26,
"payload_hex": "ffffffb9000000070db700000c80003a50715900140000000003",
"payload_valid": true,
"payload_decoded": {
"bat": 3.511,
"bat_lora": 254,
"bat_percent": 100,
"enable": true,
"ts_unix": 978350425,
"valid_datetime": true,
"valid_status": true,
"valid_gps": false,
"valid_aux": true,
"valid": true
}
}
],
"success": true
}
GET /user/device/data/{eui}
This route retrieves an overview of all data associated with a specific device identified by its EUI. The response includes timestamps, sensor readings (temperature, humidity, battery), and optional geolocation information.
- Example response:
{
"errors": [],
"debug": [],
"data": [
{
"ts_unix": 1650058921,
"time_stamp": "2022-04-15T23:42:01+02:00",
"humidity": null,
"temperature": null,
"battery": null,
"uid": 1849435
},
{
"ts_unix": 1650058921,
"time_stamp": "2022-04-15T23:42:01+02:00",
"humidity": null,
"temperature": null,
"battery": null,
"uid": 1849435
},
{
"ts_unix": 1651442490,
"time_stamp": "2022-05-02T00:01:30+02:00",
"humidity": null,
"temperature": null,
"battery": null,
"uid": 2007077,
"geoloc_LAT": 52.10214,
"geoloc_LON": 5.12111,
"geoloc_ALT": 0
},
{
"ts_unix": 1651442490,
"time_stamp": "2022-05-02T00:01:30+02:00",
"humidity": null,
"temperature": null,
"battery": null,
"uid": 2007081
},
{
"ts_unix": 1651442490,
"time_stamp": "2022-05-02T00:01:30+02:00",
"humidity": null,
"temperature": null,
"battery": null,
"uid": 2007081,
"geoloc_LAT": 52.10214,
"geoloc_LON": 5.12111,
"geoloc_ALT": 0
}
],
"success": true
}
GET user/device/result/{eui}/{uid}
This API route checks whether a specific user (identified by their UID) is associated with a given device (identified by its EUI) and returns a confirmation result.
- Example response:
{
"errors": [],
"debug": [],
"meta": [],
"data": {
"result": "25430"
},
"success": true
}