Versionen im Vergleich

Alte Version 21

changes.mady.by.user Merlin Pfeifer

Gespeichert am

verglichen mit

Neue Version Aktuell

changes.mady.by.user Simon Wheeler

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Hinweis

Diese Anleitung geht nur noch auf das Datenformat v2 ein. Frühere Formate (v1), werden nicht mehr unterstützt.

Zugriff via HTTP POST

Datenübertragung via HTTP POST. Muss im Input-Plug-Plugin in aktiviert werden.

Zugriff mit Datenformat

...

Codeblock
HTTPFür POST {IP}:{PORT}/rest/external/http

Zugriff mit Datenformat v2:
Status
colourGreen
title2.23

Codeblock
Alarme:
HTTP POST {IP}:{PORT}/rest/external/http/v2

Die folgenden Endpunkte existieren ab Version

Status
colourGreen
title2.27
:

Codeblock
Für Alarmealarm/v2 

Für Statusmeldungen:
HTTP POST {IP}:{PORT}/rest/external/http/alarmstatus/v2

Für StatusmeldungenPositionsmeldungen:
HTTP POST {IP}:{PORT}/rest/external/http/status/v2

Der oben erwähnte Endpunkt /rest/external/http/v2 existiert weiterhin, jedoch wird empfohlen, /rest/external/http/alarm/v2 für Alarme zu nutzen.

Positionsmeldungen
Status
colourGreen
title2.29

Codeblock
position/v2

Für Lagemeldungen:
HTTP POST {IP}:{PORT}/rest/external/http/positiondiary/v2

Parameter

Bedeutung

IP

Die IP-Adresse des FE2 Systems oder localhost, falls der Zugriff über

das selbe

dasselbe System erfolgt

PORT

Der Port der FE2 Weboberfläche. Standard ist hier Port 83

Daten

UTF-8 kodiertes JSON als Body eines HTTP POST Aufrufs. Das Datenformat wird hier beschrieben.

Return-Werte

Es werden die Standard-HTTP-Return-Codes verwendet. Außerdem wird ein JSON Objekt zurück geliefertzurückgeliefert.

HTTP Code

Bedeutung

200

Alarm erfolgreich übergeben

400

Der Aufruf war fehlerhaft

406

Der Alarmeingang ist deaktiviert

409

Inhalt des Aufrufs steht in Konflikt mit Einstellungen/Voraussetzungen in FE2.

Beispiel Return Objekt

Codeblock
{
  "status":"OK|NOT_OK",
  "error":"Error message"
}

Als Body wird ein UTF-8 kodiertes JSON zurückgeliefert:

Feld

Bedeutung

status

  • OK

    • Korrekte Annahme des Alarms

  • NOT_OK

    • Alarm Übergabe war fehlerhaft. Details im error Feld

error

Sollte Status NOT_OK sein, wird hier der Fehler näher beschreiben

Zugriff via HTTP GET

Datenübertragung via HTTP GET. Muss im Input-Plug-Plugin in aktiviert werden.

Warnung

Warnung

Bei dieser Variante wird der Absender nicht überprüft! Sie sollten diese Schnittstelle also nur in lokalen Netzwerken erlauben, welche Sie unter Ihrer Kontrolle haben.

...

Codeblock
HTTP GET {IP}:{PORT}/rest/external/http?message=Text&param1=value1&param2=value2

Parameter

Bedeutung

IP

Die IP-Adresse des FE2 Systems oder localhost, falls der Zugriff über

das selbe

dasselbe System erfolgt

PORT

Der Port der FE2 Weboberfläche. Standard ist hier Port 83

message

Der einzige Parameter, welcher vorgeschrieben ist. Dies ist der Alarmtext

Daten

Alle Daten können via URL Parameter im Format key=value übergeben werden. Welche URL Parameter beachtet werden, definieren Sie im Alarmeingang unter GET Parameter in folgendem Format:

Codeblock
QueryParameter;FE2Parameter

Feld

Bedeutung

QueryParameter

Geben Sie hier an, wie der entsprechende Query Parameter heißt

FE2Parameter

Unter diesem Parameter wird dann der entsprechende Wert gespeichert.

Verwendung von message

Message wird innerhalb der URL immer als Pflichtparameter erwartet.

Verwendung von address

Sollten Sie hier address angeben, wird der QueryParameter als Feld address alarmiert, wodurch spezifische Einheiten direkt alarmiert werden können

Beispiel für Definition Parameter im Alarmeingang

...

Es werden die Standard-HTTP-Return-Codes verwendet.

HTTP Code

Bedeutung

200

Alarm erfolgreich übergeben

400

Der Aufruf war fehlerhaft

Als Body wird ein einfaches OK oder NOK zurückgeliefert.