HTTP API

Die BlinkEasy-App bietet Ihnen eine einfache Möglichkeit, Ihre eigenen Anwendungen über HTTP anzusteuern. Diese erweiterte Funktion kann aktiviert werden, um benutzerdefinierte Analysen zu implementieren oder IoT-Geräte zu steuern. Beispielsweise können Sie damit die Beleuchtung in einem Smart Home regeln (Beispielcode auf GitHub).

Um dieses Feature zu aktivieren, geben Sie auf der Einstellungsseite unter "API" die gewünschte URL (HTTP oder HTTPS) ein.

HTTP-Anfragen werden gesendet, sobald ein Ereignis auftritt. Statistiken wie die aktuelle Lidschlagfrequenz werden regelmäßig übermittelt.
Um den Datenschutz zu gewährleisten, ist das HTTP-Modul auf verallgemeinerte Daten beschränkt und kann weder Videobilder noch personenbezogene Informationen senden.
Benutzerdefinierte URL-Parameter werden unterstützt, beispielsweise um Anmeldeinformationen zu übermitteln oder zwischen Geräten unterscheiden zu können.

Parameter, die mit jeder Anfrage gesendet werden:

event	ID des Ereignisses. Mögliche Werte: BLINK, START, END, BPM, ALERT, BREAK
timestamp	Seit dem 1. Januar 1970 (UTC) vergangene Millisekunden.

Beispiel:


http://localhost:3000/myscript.php?event=START&timestamp=1723321032811

Mögliche Ereignisse:

BLINK

Wird gesendet, wenn ein Lidschlag erkannt wird.

Parameter:

duration	Dauer des Lidschlags in Millisekunden
bpm	Aktuelle Lidschlagfrequenz (Lidschläge pro Minute)

Beispiel:


http://localhost:3000/myscript.php?event=BLINK&bpm=13.2&duration=185&timestamp=1723321032811

START

Wird gesendet, wenn zum ersten Mal ein Gesicht erkannt wird. Damit beginnt die Sitzung.

Beispiel:


http://localhost:3000/myscript.php?event=START&timestamp=1723321032811

END

Wird gesendet, wenn timeout Millisekunden lang kein Gesicht erkannt wurde. Damit endet die aktuelle Sitzung.

Parameter:

timeout

Aktuelles Sitzungs-Timeout in Millisekunden. Der Zeitpunkt, zu dem zuletzt ein Gesicht erkannt wurde, ergibt sich aus dem timestamp des Ereignisses minus timeout.

Beispiel:


http://localhost:3000/myscript.php?event=END&timeout=60&timestamp=1723321032811

BPM

Regelmäßig gesendetes Ereignis

Parameter:

bpm	Aktuelle Lidschlagfrequenz in Lidschlägen pro Minute.

Beispiel:


http://localhost:3000/myscript.php?event=BPM&bpm=13.2&timestamp=1723321032811

ALERT

Wird gesendet, wenn die Lidschlagfrequenz unter den festgelegten Schwellenwert fällt. Dieses Ereignis wird auch gesendet, wenn die Blinzel-Erinnerungen deaktiviert sind.

Parameter:

bpm	Aktuelle Lidschlagfrequenz in Lidschlägen pro Minute.
target	Der Schwellenwert, den die aktuelle Lidschlagfrequenz unterschritten hat.
duration	Anzahl der Millisekunden unterhalb des Zielwerts, bis die Erinnerung ausgelöst wurde.

Beispiel:


http://localhost:3000/myscript.php?event=ALERT&bpm=13.2&target=15.0&duration=12&timestamp=1723321032811

BREAK

Eine Pausenerinnerung wurde ausgelöst.

Parameter:

keine

Beispiel:


http://localhost:3000/myscript.php?event=BREAK&timestamp=1723321032811