IBM Node-RED

L'interface API ouverte de smart-me s'intègre très facilement dans les flux d'IBM Node-Red. Créez des flux de travail à l'aide de requêtes HTTP et de notre API, avec l'ensemble des données et des possibilités de commande.

Lire les valeurs des compteurs - GET

Pour utiliser l'API, vous avez besoin des blocs HTTP-Request de Node-Red.

La requête HTTP

Les requêtes HTTP reposent sur nos commandes API et sont saisies sous forme d'URL.

https://smart-me.com...

• .../api/devices --> Lire tous les appareils du compte (liste)

• .../api/devices/{id} --> Lire les données actuelles d'un compteur donné ; l'ID peut être obtenu au moyen de api/devices.

Voici la commande permettant d'interroger les informations actuelles d'un compteur donné :

https://smart-me.com/api/devices/{ID-du-compteur} --> https://smart-me.com/api/devices/32b30ab1-3ac5-4...

• Toutes les commandes API et l'outil de test : API

Authentification :

Pour l'authentification, vous pouvez utiliser l'authentification Basic avec le nom d'utilisateur et le mot de passe de votre compte smart-me.

Les Change-Nodes vous permettent de réduire le message dans la payload aux données pertinentes, p. ex. ActivePower.

msg.payload.ValueName (même orthographe que dans le JSON)

À titre d'essai, ici avec la valeur de ActivePower => 3.008

Exemples :

• ActivePower

• CounterReading

• CurrentL1

Commuter les E/S - POST

Le node HTTP-Request permet de commander nos sorties. Pour ce faire, un code JSON doit être envoyé via un node HTTP-Request.

La commande POST correspondante est la commande http://smart-me.com/api/actions.

La commande GET /api/actions/{id} permet de trouver les sorties disponibles pour l'appareil concerné.

Pour les Telstar 80A et CT, les codes OBIS des sorties sont toujours les mêmes.

(Notez que seules les sorties numériques définies côté appareil sont listées)

Output api/actions/{id}:
[
  {
    "Name": "Output 0",			"S0-0 Ausgang"
    "ObisCode": "63000C0101FF",
    "ActionType": 0
  },
  {
    "Name": "Relais",			"S1 Ausgang"
    "ObisCode": "63000C0102FF",
    "ActionType": 0
  }
]

Configuration POST avec la commande api/actions

Structure de commande JSON pour la commande POST api/actions dans l'Inject-Node : commuter le relais S1 de 0 (OFF) à 1 (ON).

{

"DeviceID": "string",

"Actions": [

{

"ObisCode": "string",

"Value": 0

}

]

}

Support pour Node-RED

Pour le traitement ultérieur des données dans Node-Red, informez-vous sur le site web et auprès de la communauté Node-RED.

https://nodered.org/

Pour des informations détaillées sur les commandes : https://smart-me.com/swagger/ui/index#!/AccessToken/AccessToken_Put