HTTP-Schnittstelle

Mittels der HTTP-API können Access Points LBS-Daten direkt an einen frei konfigurierbaren HTTP-Endpunkt senden. Da die Daten im JSON-Format vorliegen, wird eine einfache Verarbeitung auf der Empfängerseite sichergestellt.

HTTP Server-URL: Konfigurieren Sie hier die URL des HTTP-Endpunkts.
Anmerkung: Es werden HTTP und HTTPS unterstützt. Bei der Verwendung von HTTPS kann entweder keine Zertifikatsprüfung, eine Prüfung des Server-Zertifikat oder eine beidseite Prüfung mit Server- und Client-Authentisierung stattfinden. Dazu kann ein PKCS#12-Container mit CA- und Client-Zertifikat auf das Gerät hochgeladen werden, der das CA-Zertifikat oder das CA- und Client-Zertifikat enthält. Dies kann über LANconfig oder WEBconfig erfolgen.Wird kein PKCS#12-Container hochgeladen, wird bei Verwendung von HTTPS keine Zertifikatsprüfung durchgeführt.

Abbildung 1. Screenshot WEBconfig
HTTP-Server-Secret: Das HTTP-Server-Secret wird in den JSON-Nachrichten des Access Points zum Endpunkt übertragen und kann dazu dienen, die Nachrichten zusätzlich zu authentifizieren.
HTTP-Datenquellen: Konfigurieren Sie hier, ob WLAN-, BLE- oder beide Arten von LBS-Daten gesendet werden sollen.
Anmerkung: Die Einstellung BLE ist nur bei Geräten mit mit verbautem BLE-Modul unterstützt.
Absende-Adresse: Konfigurieren Sie hier, welche Absendeadresse für die Kommunikation mit dem HTTP-Endpunkt verwendet werden soll. Dies kann erforderlich sein, wenn auf dem Gerät mehrere IP-Netzwerke konfiguriert sind.
Messfelder: Konfigurieren Sie hier im Detail, welche Messfelder bzw. vom Access Point ermittelten Daten in den Nachrichten an den HTTP-Endpunkt enthalten sein sollen. Es empfiehlt sich, diese auf den tatsächlich benötigten Umfang anzupassen, um das Datenaufkommen gering zu halten.

Datenformat der an den Endpunkt gesendeten Nachrichten

Für WLAN:
```
{
  "version": "1.0",
  "secret": "geheim",
  "type": "WLAN",
  "deviceMac": "00a057000000",
  "measurements": [
    {
      "clientMac": "334455667788",
      "seenTime": 1579792598996,
      "frameSeqNum": 1074,
      "ssid": "",
      "module": 0,
      "bssid": "00a057000000",
      "rssi": -56,
      "frequency": 2462,
      "noise": -70,
      "frameType": "PROBE"
    },
    {
      "clientMac": "554433aabbcc",
      "seenTime": 1579792601334,
      "frameSeqNum": 2742,
      "ssid": "",
      "module": 0,
      "bssid": "00a057000000",
      "rssi": -45,
      "frequency": 2462,
      "noise": -70,
      "frameType": "PROBE"
    }
  ]
}
```
version

Die Version der verwendeten API. Aktuell ist dies immer 1.0.

secret

Das in der Konfiguration des Access Points festgelegte HTTP-Server-Secret.

type

Der Typ der gesendeten Daten. Kann entweder WLAN oder BLE sein.

deviceMac

Die LAN-MAC-Adresse des Access Points.

measurements

Hierin ist mindestens ein Messwert enthalten. Es können aber auch mehrere enthalten sein.

clientMac

Die MAC-Adresse des WLAN-Clients.

seenTime

Der Zeitstempel (in Unix-Zeit), zu dem der WLAN-Frame vom Client am Access Point empfangen wurde.

frameSeqNum

Die Sequenznummer des empfangenen WLAN-Frames.

ssid

Die im WLAN-Frame enthaltene SSID, sofern vorhanden.

module

Beschreibt, von welcher WLAN-Schnittstelle des Access Points der WLAN-Frame empfangen wurde. Typischerweise 0 für die erste WLAN-Schnittstelle oder 2 für die zweite WLAN-Schnittstelle.

bssid

Die im WLAN-Frame enthaltene BSSID.

rssi

Die Signalstärke in dBm des empfangenen WLAN-Frames.

frequency

Die Frequenz in MHz des WLAN-Kanals, auf dem der WLAN-Frame empfangen wurde.

noise

Der Rauschpegel in dBm auf dem Kanal, auf dem der WLAN-Frame empfangen wurde.

frameType

Der Frame-Typ des empfangenen WLAN-Frame. Folgende Typen sind möglich: PROBE, AUTHENTICATION, ASSOCIATION, DEAUTHENTICATION oder DEASSOCIATION.
Für BLE:
```
{
  "version": "1.0",
  "secret": "geheim",
  "type": "BLE",
  "deviceMac": "00a057000000",
  "measurements": [
    {
      "deviceAddress": "001122334455",
      "seenTime": 1579792601269,
      "addressType": "Random",
      "rssi": -77
    },
    {
      "deviceAddress": "ffeeddccbbaa",
      "seenTime": 1579792601273,
      "addressType": "Random",
      "rssi": -61
      "name": "test",
      "advertisingData": "1eff0600010920024bab81ba8815c5dc61c38449a886740a1ddb09b9e2ad8e",
      "scanResponseData": "050974657374"
    }
  ]
}
```
version

Die Version der verwendeten API. Aktuell ist dies immer 1.0.

secret

Das in der Konfiguration des AP festgelegte HTTP-Server-Secret.

type

Der Typ der gesendeten Daten. Kann entweder WLAN oder BLE sein.

deviceMac

Die LAN-MAC-Adresse des AP.

measurements

Hierin ist mindestens ein Messwert enthalten. Es können aber auch mehrere enthalten sein.

deviceAddress

Die Adresse des BLE-Gerätes bzw. -Clients.

seenTime

Der Zeitstempel (in Unix-Zeit), zu dem der BLE-Frame vom Client am AP empfangen wurde.

addressType

Der BLE-Adresstyp. Folgende Adresstypen sind möglich: Public oder Random.

rssi

Die Signalstärke in dBm des empfangenen BLE-Frames.

name

Der vom BLE-Gerät übermittelte Name. Kann nur übermittelt werden, wenn der aktive BLE-Scan in den BLE-Betriebseinstellungen aktiviert ist.

advertisingData

Das komplette vom BLE-Gerät übermittelte Advertisement.

scanResponseData

Die komplette vom BLE-Gerät übermittelte Scan-Response. Kann nur übermittelt werden, wenn der aktive BLE-Scan in den BLE-Betriebseinstellungen aktiviert ist.