IBM Node-RED

L'interfaccia API aperta di smart-me si integra molto facilmente nei flussi di IBM Node-Red. Crea flussi di lavoro con le richieste HTTP e la nostra API, con l'intera gamma di dati e funzioni di controllo.

Leggere i valori dei contatori - GET

Per usare l'API ti servono i nodi HTTP request di Node-Red.

La richiesta HTTP

Le richieste HTTP si basano sui nostri comandi API e vengono inserite come URL.

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

• .../api/devices --> Legge tutti i dispositivi dell'account (elenco)

• .../api/devices/{id} --> Legge i dati attuali di un determinato contatore; l'ID si può ricavare con api/devices.

Ecco il comando per richiedere le informazioni attuali di un determinato contatore:

https://smart-me.com/api/devices/{Zähler-ID} --> https://smart-me.com/api/devices/32b30ab1-3ac5-4...

• Tutti i comandi API e lo strumento di test: API

Autenticazione:

Per l'autenticazione puoi usare la Basic Authentication con nome utente e password del tuo account smart-me.

Con i nodi Change puoi ridurre il messaggio nel payload ai soli dati rilevanti, ad esempio ActivePower.

msg.payload.ValueName (stessa grafia del JSON)

Come prova, qui con il valore di ActivePower => 3.008

Esempi:

• ActivePower

• CounterReading

• CurrentL1

Commutare I/O - POST

Con il nodo HTTP request è possibile comandare le nostre uscite. A questo scopo occorre inviare un codice JSON tramite un nodo HTTP request.

Il comando POST corrispondente è il comando http://smart-me.com/api/actions.

Con il comando GET /api/actions/{id} puoi trovare le uscite disponibili per il rispettivo dispositivo.

Per Telstar 80A e Telstar CT i codici OBIS delle uscite sono sempre gli stessi.

(Tieni presente che vengono elencate solo le uscite digitali definite sul dispositivo)

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

Configurazione POST con il comando api/actions

Struttura JSON del comando POST api/actions nel nodo Inject: commutare il relè S1 da 0 (OFF) a 1 (ON).

{

"DeviceID": "string",

"Actions": [

{

"ObisCode": "string",

"Value": 0

}

]

}

Supporto per Node-RED

Per l'ulteriore elaborazione dei dati in Node-Red, informati sul sito web e nella community di Node-RED.

https://nodered.org/

Per informazioni dettagliate sui comandi: https://smart-me.com/swagger/ui/index#!/AccessToken/AccessToken_Put