Node-RED est un outil de flux gratuit et open source qui tourne sur votre propre matériel ou serveur. Il n'y a ni compte ni intermédiaire : DynamiHost envoie l'événement scan.created directement à votre instance Node-RED chaque fois qu'un de vos codes dynamiques est scanné, et votre flow prend le relais.

Ce qu'il vous faut

  • Une offre DynamiHost avec les webhooks : Trial, Pro ou Business. Si la page Webhooks de votre tableau de bord affiche un message de verrouillage, votre offre n'inclut pas encore les webhooks.
  • Une instance Node-RED en marche, joignable à une adresse HTTPS publique. DynamiHost ne peut pas livrer à localhost ni à d'autres adresses privées, et les URL d'endpoint sur des réseaux privés sont rejetées à l'enregistrement.

Étape 1 : obtenez une URL de webhook depuis Node-RED

  1. Dans l'éditeur Node-RED, ajoutez un nœud HTTP In à un flow et réglez sa méthode sur POST.
  2. Donnez-lui un chemin reconnaissable, par exemple /dynamihost-scans. L'URL du nœud est l'adresse de votre instance plus ce chemin.
  3. Ajoutez après lui un nœud HTTP Response réglé pour retourner le statut 200, et reliez le tout. DynamiHost traite toute réponse 2xx comme une livraison réussie, et tout le reste comme un échec à réessayer.
  4. Cliquez sur Deploy. L'URL n'est active qu'une fois le flow déployé.

Protégez l'instance elle-même (le mot de passe de l'éditeur Node-RED et HTTPS) avant de l'exposer : toute personne qui trouve le chemin peut y poster, alors vérifiez la signature comme décrit ci-dessous si le flow fait quelque chose d'important.

Étape 2 : ajoutez l'URL dans DynamiHost

  1. Ouvrez Webhooks dans le tableau de bord et cliquez sur Add endpoint.
  2. Collez l'URL complète de votre nœud HTTP In et sélectionnez l'événement scan.created.
  3. Enregistrez, puis copiez le secret de signature affiché une seule fois pour l'endpoint. Un nœud Function peut le vérifier : la page Intégrations du tableau de bord contient un extrait Node prêt à l'emploi pour ce contrôle, et les en-têtes entrants sont sur le message que Node-RED transmet.

Étape 3 : testez la connexion

Sur la page Webhooks, cliquez sur Send test sur votre nouvel endpoint. Ajoutez un nœud Debug à votre flow et regardez la charge utile d'exemple arriver dans la barre latérale de débogage. Scannez ensuite un de vos codes avec votre téléphone et regardez l'événement réel suivre.

Ce qui arrive

Chaque livraison est l'événement scan.created : l'identifiant du code, son code court et son nom, l'heure du scan et, quand ils sont connus, le pays, la ville, l'appareil, le système d'exploitation, le navigateur et le référent. Le format complet de la charge utile, la vérification de la signature, les réessais et la règle de désactivation automatique sont décrits dans Webhooks : soyez notifié à chaque scan, dans ce centre d'aide.

Idées d'automatisation

  • Commutez une lampe connectée, un relais ou un écran dans votre lieu quand un code est scanné, via MQTT ou un nœud d'API locale.
  • Ajoutez les scans à un fichier local ou une base de données pour des rapports hors ligne.
  • Transmettez les scans à un autre système interne non joignable depuis Internet, avec Node-RED comme pont.