Pushservice:Protokollbeschreibung

Aus ARTECO Wiki
Version vom 19. Februar 2020, 13:32 Uhr von Alex (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Datensätze werden als HTTP-POST ausgeliefert. Eine TLS-Verschlüsselung ist problemlos möglich und wird dringend empfohlen. Lediglich für Testzwecke mit nicht-sensiblen Daten kann kurzzeitig auch eine unverschlüsselte Verbindung verwendet werden. Die URL wird wie unter "Endpunkt" beschrieben hinterlegt.

Beispiel mit Header

POST / HTTP/1.1
Host: xxxxxxxxxxxx:6666
User-Agent: qpushd
Content-Type: application/json
Content-Length: 126
Connection: Keep-Alive
Accept-Encoding: gzip, deflate
Accept-Language: de-DE,en,*

{"CK":"56","DN":"12","LA":"52.686185","LO":"13.195125","PG":"66","PV":"0","SN":"xxxxxxxxxxxxxxxx","ST":"005","TS":"190219130056"}

Payload

Die Nutzdaten werden als JSON-formatierte Variante des Efb108er Protokoll (Protokollbeschreibung) gesendet. Jeder Datensatz wird um die Seriennummer des Systems erweitert. Die Seriennummer hat den Key "SN".

Derzeit werden alle Values als String gesendet. Dies kann sich eventuell in der Zukunft ändern, sodass Zahlen korrekt als Integer oder Gleitkommazahlen gesendet werden.

Beispiel:

{
 "PG": "1338-1137",
 "SN": "1337",
 "ST": "020",
 "TS": "031109221826",
 "LO": "13.523052",
 "LA": "52.553085",
 "DN": "48",
 "CS": "000",
 "SP": "000",
 "MX": "066",
 "KM": "1.6",
 "IO": "430,0,0,0,0,0,384,0,553,520,415",
 "GQ": "24",
 "SQ": "08,1.28",
 "DV": "",
 "PV": "0",
 "CK": "14"
}