parcourir
Voici un article sur la configuration de votre Datastream Webhook .
Un Datastream Webhook est une communication HTTPS entre notre backend Wattsense et votre serveur Web.
Disponible uniquement avec un abonnement Tower, lorsque notre backend recevra une valeur, un événement ou une alarme de la part de Tower, il sera automatiquement envoyé à votre serveur Web.
Architecture du Datastream Webhook
Prérequis pour configurer Datastream Webhook
Afin de configurer correctement la communication Webhook, vous devrez obtenir (à partir des paramètres de votre serveur Web, Wattsense ne les possède pas) les informations importantes qui permettront à notre Backend de s'y connecter.
Pour cela, vous aurez besoin de :
| l'URL de base | L'URL de base où votre serveur Web est accessible. |
| Event / Alarm / Values route | Vous devrez renseigner les différentes URL finales des routes où vous souhaitez recevoir les données. |
| Secret key | Clé envoyée avec les données pour vérifier l'intégrité du message |
| Authentification |
Vous verrez ici toutes les différentes configurations d'authentification. Lorsque vous en sélectionnez une, vous devrez remplir les champs en fonction de la configuration de votre serveur Web. |
Configuration étape par étape
Configuration du connecteur
Tout d'abord, dans le menu de gauche "Organisation" / onglet Datastream, sélectionnez l'organisation dans laquelle vous souhaitez créer votre flux de données Webhook et cliquez sur "Ajouter un connecteur".
| Vous pouvez créer plusieurs connecteurs Webhook par flux de données |
Nommez votre flux de données Webhook et remplissez les champs en fonction des requis de votre serveur Web :
Configuration des triggers
Une fois la configuration de la communication effectuée, vous devrez créer les triggers :
Les triggers définissent les conditions requises pour appeler le connecteur et envoyer des valeurs.
Lorsque vous cliquez sur le bouton "Créer votre premier trigger", voici l'interface que vous devrez remplir :
- Sélectionnez le type de trigger que vous souhaitez recevoir sur votre serveur Web.
- Ajoutez la ou les Towers de la liste dans la portée du trigger. (Notez que vous ne verrez que les Towers de l'organisation actuelle, pas celles d'une autre organisation.)
Activer le datastream
A la fin de la configuration, n'oubliez pas d'activer le datastream en activant le bouton bascule
Format des données
Les données sont envoyées avec la structure suivante :
deviceId: String,
property: String,
timestamp: Long,
payload: Any,
receivedAt: Long?
scaledPayload: Number?
name: String?
unit: String?
externalId: String?
propertyId: String?
equipmentId: String?
gatewayInterfaceId: String?
slug: String?
isOutOfService: Boolean?
tags: Map<String, String>
Le ? à la fin de la ligne signifie que le champ peut être nul.
Voici un exemple :
Si vous avez besoin d'informations supplémentaires, veuillez nous contacter ici.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.