Pushservice:Protokollbeschreibung: Unterschied zwischen den Versionen

Aus ARTECO Wiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „Als Grundlage dient die JSON-Variante des Efb108er Protokoll (Protokollbeschreibung). Jeder Datensatz wird um die Seriennummer des Systems erwei…“)
 
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 1: Zeile 1:
Als Grundlage dient die JSON-Variante des Efb108er Protokoll ([[Protocols|Protokollbeschreibung]]). Jeder Datensatz wird um die Seriennummer des [[Systems]] erweitert. Die Seriennummer hat den Key "SN".
+
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|"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 ([[Protocols|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"
 +
}

Aktuelle Version vom 19. Februar 2020, 13:32 Uhr

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"
}