Administration interface: HTTP Callbacks
The HTTP Callbacks tab allows the user to schedule HTTP callbacks to send beacon data
periodically to a pre-set server.
If HTTP callbacks are configured, BlueBeacon Gateway will periodically make one (or
more) HTTP call to the configured address by sending a JSON code containing the
beacon data within the body of the HTTP call.
To configure an HTTP callback, the following parameters must be specified:
•
Callback Mode
: the callback category
◦
Periodic
: periodic callback scheduled at regular time intervals
▪
Interval
: time interval (in seconds) to which the callback is scheduled
◦
Location
: scheduled periodic callback every 1 second, only for beacon in
iBeacon format, used to set up localization systems, the JSON integrates RSSI
data averaged over a time interval of 1s and contains values useful for
estimating the beacon's position
•
URL
: the URL to be called for the HTTP callback
•
Filter
: any filtering on the frames sent by the beacons
Figure 10 shows the interface for inserting and configuring an HTTP callback.
As of firmware version v4.2, the data sent by BlueBeacon Gateway are accompanied by a
signature that allows to perform a further verification of integrity and authentication. The
signature is calculated on the JSON relative to the array of beacons using a HMAC-
SHA256 algorithm that has as key a one-key based based constituted by SHA256 hash of
the concatenation of GatewayID, Gateway password and the timestamp attached to the
data sent.
Example
Data sent in HTTP POST from BlueBeacon Gateway:
{
"gateway": "00000000087569a7",
"beacons": [
{
"bdaddr": "e0:37:a2:3d:bb:08",
"timestamp": "2018-04-16 12:19:46.914 GMT+0200 (CEST)",
"rssi": -62,
"connectable": true,
"ibeacon": [
{
"rssi": -65,
"uuid": "acfd065ec3c011e39bbe1a514932ac01",
"major": 0,
"minor": 18000,
"measuredPower": -62,
"timestamp": "2018-04-16 12:19:49.57 GMT+0200 (CEST)"
BlueUp S.r.l.s. - 2018
V1.0– 26/06/2018
19/28
