API HTTP
BlinkEasy s’intègre facilement à vos propres applications. Vous pouvez par exemple créer vos propres statistiques ou piloter des objets connectés, notamment pour régler l’éclairage en fonction de la fréquence de clignement.
Pour activer cette fonction avancée, indiquez une URL de rappel (callback) dans la page des réglages. Consultez l’exemple de code pour ESP32.
- Pour protéger votre vie privée, le module HTTP se limite à des données générales et ne peut envoyer ni images vidéo ni informations permettant de vous identifier.
- Les requêtes sont envoyées instantanément lorsqu’un événement se produit, et périodiquement pour transmettre des statistiques comme la fréquence de clignement actuelle.
- Vous pouvez ajouter vos propres paramètres, par exemple pour transmettre des identifiants ou distinguer plusieurs appareils.
Paramètres envoyés avec chaque requête :
| event | Identifiant de l’événement. Valeurs possibles : BLINK, START, END, BPM, ALERT, BREAK |
| timestamp | Nombre de millisecondes écoulées depuis le 1er janvier 1970 (UTC). |
Example:
http://localhost:3000/myscript.php?event=START×tamp=1723321032811
Événements possibles :
BLINK
Envoyé lorsqu’un clignement est détecté.
Paramètres :
| duration | Durée du clignement en millisecondes |
| bpm | Fréquence de clignement actuelle (clignements par minute) |
Example:
http://localhost:3000/myscript.php?event=BLINK&bpm=13.2&duration=185×tamp=1723321032811
START
Envoyé lorsqu’un visage est détecté pour la première fois, ce qui démarre la session.
Example:
http://localhost:3000/myscript.php?event=START×tamp=1723321032811
END
Envoyé lorsqu’aucun visage n’a été détecté pendant timeout millisecondes, ce qui met fin à la session en cours.
Paramètres :
| timeout | Délai d’expiration de la session en cours, en millisecondes. Le dernier instant où un visage a été reconnu correspond au timestamp de l’événement moins le timeout. |
Example:
http://localhost:3000/myscript.php?event=END&timeout=60×tamp=1723321032811
BPM
Événement périodique
Paramètres :
| bpm | Fréquence de clignement actuelle, en clignements par minute. |
Example:
http://localhost:3000/myscript.php?event=BPM&bpm=13.2×tamp=1723321032811
ALERT
Envoyé lorsque la fréquence de clignement de l’utilisateur passe sous le seuil défini. Cet événement est également envoyé lorsque les rappels de clignement sont désactivés.
Paramètres :
| bpm | Fréquence de clignement actuelle, en clignements par minute. |
| target | Seuil sous lequel la fréquence de clignement actuelle est passée. |
| duration | Nombre de millisecondes passées sous l’objectif avant l’émission de l’alerte. |
Example:
http://localhost:3000/myscript.php?event=ALERT&bpm=13.2&target=15.0&duration=12×tamp=1723321032811
BREAK
Un rappel de pause a été émis.
Paramètres :
aucun
Example:
http://localhost:3000/myscript.php?event=BREAK×tamp=1723321032811