Nearby Device Finder API
- Evgeny Aleshin
- Pavel Kudinov
Links to documentation
Development: https://devicefinder.dev.api.nwave.io/docs/openapi#/
Production: https://devicefinder.prod.api.nwave.io/docs/openapi#/
Authorization
In order to authorize with this API, you need to provide the authorization token in the X-Auth-Token header. Details on obtaining the token are available here: REST Occupancy API | Authorization
Endpoints
/find_nearby_devices
This endpoint retrieves device information and returns a summary of advertisings for each device.
Advertising summary includes average rssi, number of advertisings and the last advertising time.
Request:
{
"advertising_packets": [
{
"rssi": 0,
"msd": "string",
"time": "2021-09-21T16:57:04.601Z"
}
]
}rssi: stands for Received Signal Strength Indicator. This is an integer value that is less than 0 that represents signal strength of the received advertising packet.
msd: a hexadecimal string which stands for Manufacturer Specific Data. To filter out all not-Nwave advertising packets, check that first 2 bytes of msd are in range 0x5710 - 0x571F.
time: iso8601 timestamp of advertising packet reception.
Response:
{
"devices": [
{
"device_id": "string",
"network_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lat": 0,
"lon": 0,
"labels": [
"string"
],
"custom_id": "string",
"group_id": 0,
"group_name": "string",
"group_custom_id": "string",
"level_id": 0,
"level_name": "string",
"floor_number": 0,
"zone_id": 0,
"zone_name": "string",
"project_id": 0,
"project_name": "string",
"damaged": true,
"occupied": true,
"status_duration": 0,
"time": "2021-09-21T16:57:04.604Z",
"average_rssi": 0,
"count_of_advertisements": 0
}
]
}device_id: hexadecimal string
damaged: boolean value representing device’s damaged status
occupied: boolean value representing device’s occupancy status
status_duration: integer representing the duration of the current occupancy status
time: latest advertising timestamp from the device
average_rssi: mean rssi of all the advertising packets from the device
count_of_advertisiments: integer count of advertising packets from the device