Under HTTP-Server you configure the HTTP endpoints for the LBS data.
- URL
-
Configure the URL of the HTTP endpoint here.
Note: HTTP and HTTPS are supported. If you use HTTPS, a CA certificate for server verification must also be uploaded to the device. This can be done using WEBconfig. See Location based services.
- Secret
- The secret (key) is transmitted from the access point to the end point in the JSON messages and can additionally be used for message authentication.
- Data-Sources
- Here you configure the types of LBS data that should be sent. Only BLE is currently available.
- BLE-Measurements-Fields
- Here you configure which measurement fields or data from the access point should be included in the messages to the HTTP endpoint. In order to minimize the data volume, we recommend that you limit this to essential data only.
- Buffering Timeout
- After the configured time (in seconds) is reached, all BLE messages buffered up to that point are sent to the server.
- Buffer Size
-
After the configured data quantity (in bytes) is reached, all BLE messages buffered up to that point are sent to the server.
Note: With the value for Buffering Timeout and Buffer Size both set to 0, the messages are sent to the server as soon as possible.
Data format of the messages sent to the endpoint
- For BLE:
{ "deviceMac": "00A0574C49EB", "measurements": [ { "addressType": "Random", "deviceAddress": "70CE7B7014EC", "name": "", "rssi": -93, "seenTime": 1599208076493 }, { "addressType": "Random", "deviceAddress": "70CE7B7014EC", "name": "", "rssi": -93, "seenTime": 1599208076494 "advertisingData": "1eff0600010920024bab81ba8815c5dc61c38449a886740a1ddb09b9e2ad8e", "scanResponseData": "050974657374" } ], "secret": "", "type": "BLE", "version": "1.0" }
- version
- The version of the API being used. Currently this is always 1.0.
- secret
- The HTTP server secret specified in the access point configuration.
- type
- The type of data sent. Can be either WLAN or BLE.
- deviceMac
- The LAN MAC address of the access point.
- measurements
- This contains at least one measured value. This could also be a number of measurements.
- deviceAddress
- The address of the BLE device or client.
- seenTime
- The time stamp (in Unix time) when the BLE frame from the client was received by the access point.
- addressType
- The type of BLE address. The following address types are available: Public or Random.
- rssi
- The signal strength in dBm of the received BLE frame.
- name
- The name submitted by the BLE device. Only transmitted if the BLE scanner is activated in the BLE operational settings.
- advertisingData
- The complete advertisement transmitted by the BLE device.
- scanResponseData
- The complete scan response transmitted by the BLE device. Only transmitted if the BLE scanner is activated in the BLE operational settings.