HTTP Rest API

Die DoorLine Snap unterstützt API-Funktionen, welche eine einfache Integration mit kompatiblen Systemen und Komponenten ermöglichen.

Für alle Tekkies, Tüfler, Bastler, Maker und Entwickler wird die Schnittstelle nachfolgend beschrieben.

HTTP Requests zur DoorLine

Die DoorLine unterstützt eingehende HTTP GET-Requests.

Die URL ist nach diesem Schema aufgebaut:

http://{ip-address}/api/{endpoint}?pin={pin}&{parameter}={value}&{parameter}={value}

Dabei sind die Platzhalter entsprechend zu ersetzen:

{ip-address} = IP-Adresse der DoorLine im Netzwerk

{pin} = Konfigurierter PIN der DoorLine

{endpoint}, {parameter}, {value} = je nach gewünschter Aktion - siehe nachfolgende Beschreibung

Aktionen auslösen

Endpoint	Parameter
`out01/trigger`	duration (500 - 60000)	Relaiskontakt 1 für Dauer in Millisekunden einschalten
`out01/on`		Relaiskontakt 1 einschalten
`out01/off`		Relaiskontakt 1 abschalten
`out02/trigger`	duration (500 - 60000)	Relaiskontakt 2 für Dauer in Millisekunden einschalten
`out02/on`		Relaiskontakt 2 einschalten
`out02/off`		Relaiskontakt 2 abschalten
`button_backlight/trigger`	duration (100 - 60000)	Beleuchtung der Klingeltaste für Dauer in Millisekunden umschalten
`beep/trigger`	duration (100 - 60000) frequency (200 - 10000)	Piep mit Dauer von `duration` Millisekunden und Frequenz `frequency` ausgeben

HTTP-Response

Bei erfolgreicher Auslösung der jeweiligen Aktion antwortet die DoorLine mit HTTP Status 200.

Beispiele

Als IP-Adresse für die DoorLine wird 192.168.178.30 und 0000 als PIN angenommen

Relais 1 für 2 Sekunden einschalten

http://192.168.178.30/api/out01/trigger?pin=0000&duration=2000

Relais 2 einschalten

http://192.168.178.30/api/out02/on?pin=0000

Relais 2 abschalten

http://192.168.178.30/api/out02/off?pin=0000

Piep ausgeben

http://192.168.178.30/api/beep/trigger?pin=0000&duration=500&frequency=1200

Werte abfragen

Endpoint	Beschreibung	Rückgabewert
`button01/since_ring`	Zeit in Sekunden seit letzter Auslösung der Klingeltaste 1	0 - 2^32 (Integer)
`button01/count`	Anzahl Auslösungen seit Klingeltaste 1 Systemstart	0 - 2^32 (Integer)
`button02/since_ring`	Zeit in Sekunden seit letzter Auslösung der Klingeltaste 2	0 - 2^32 (Integer)
`button02/count`	Anzahl Auslösungen seit Klingeltaste 2 Systemstart	0 - 2^32 (Integer)
`in01/status`	Status Schalteingang (0 = offen, 1 = geschlossen)	0 / 1 (Integer)
`light_sensor/value`	Status Helligkeit Kamerabild (0 = dunkel, 1 = hell)	0 / 1 (Integer)
`sip/status`	Statuscode letzte SIP-Verbindung	(String)
`out01/status`	Schaltzustand Relaiskontakt 1	0 / 1 (Integer)
`out02/status`	Schaltzustand Relaiskontakt 2	0 / 1 (Integer)
`system/uptime`	Zeit seit Systemstart in Sekunden	0 - 2^32 (Integer)
`system/firmware`	Installierte Firmware-Version	(String)

Jeder Wert muss in einem separaten HTTP GET-Request abgefragt werden.

Zwischen den einzelnen HTTP-Requests die zur DoorLine geschickt werden, muss eine Pause von mindestens einer Sekunde eingehalten werden

HTTP-Response

Im Erfolgsfall antwortet die DoorLine mit HTTP Status 200. Der Rückgabewert wird als Content-Type: text/html mitgeliefert.

Beispiele

Als IP-Adresse für die DoorLine wird 192.168.178.30 und 0000 als PIN angenommen

Anzahl Auslösungen Taste 1

http://192.168.178.30/api/button01/count?pin=0000

Sekunden seit Systemstart

http://192.168.178.30/api/system/uptime?pin=0000

HTTP Push-Benachrichtigungen von der DoorLine

In der Konfigurationsoberfläche der DoorLine können “API-Aktionen” konfiguriert werden.

Dabei können vier getrennte Aktionen (Auslöser) konfiguriert werden und dazu jeweils eine HTTP-URL eingestellt werden. Auf die konfigurierte URL wird bei eintreten der Aktion ein HTTP GET-Request abgesetzt.

Für zeitkritische Ereignisse, wie das Türklingeln oder das Auslösen eines Türöffners sollten immer die Push-Benachrichtigungen bevorzugt werden. Damit erreicht man kürzere Verzögerungszeiten und werden weniger Ressourcen benötigt als beim Polling der Abfragewerte