Shelly offre una gamma diversificata di API per i suoi dispositivi, consentendo un'integrazione flessibile. Ogni dispositivo può essere programmato individualmente, funzionando sia come unità autonoma senza Shelly Cloud sia tramite un'API cloud sicura per il controllo remoto.

Con queste API puoi gestire i dispositivi Shelly - eseguire comandi (ma non modificare le impostazioni del dispositivo), ricevere eventi in tempo reale sui cambiamenti di stato del dispositivo, abilitando capacità di monitoraggio e automazione.

Lo scopo di questo articolo è descrivere a un livello molto alto la differenza tra Shelly Cloud API, Integrator API e Shelly Fleet Manager - SFM (SaaS). Sebbene tutti e 3 siano servizi cloud, ci sono differenze tra loro e servono a scopi diversi.

Glossario rapido:

• WebSocket - WebSocket è un protocollo di comunicazione che fornisce una connessione permanentemente aperta (canale) e comunicazione bidirezionale su una singola connessione Transmission Control Protocol. In termini di gestione dei dispositivi Shelly, il cloud Shelly può inviare push con WebSocket, mentre l'API basata su HTTP funziona con il principio di richiesta e risposta (pooling) - quindi la connessione viene chiusa.

• Cloud Control API - API sicura per il controllo dei dispositivi Shelly tramite Shelly cloud a livello di account utente. Serve per controllare programmaticamente i dispositivi all'interno di un singolo account. È necessaria la gestione delle credenziali di ogni account. L'accesso a tutti i dispositivi all'interno dell'account è garantito.
  Cloud Control API ha 2 metodi di comunicazione:

  • Controllo e Stato tramite HTTP API - API destinata a essere utilizzata da fornitori di servizi che offrono servizi a valore aggiunto per integrazione a livello di singolo account utente da Shelly Cloud Control tramite comunicazione HTTP senza stato.

  • Controllo e Eventi in Tempo Reale tramite WebSocket - API destinata a essere utilizzata da fornitori di servizi che offrono servizi a valore aggiunto per integrazione a livello di singolo account utente da Shelly Cloud Control ma l'autenticazione avviene tramite OAuth. Il token di accesso ha lunga durata ed è invalidato al cambio password.
    Questa è una comunicazione live tramite WebSocket.

• Integrator API - API Cloud-to-Cloud per integrazione, controllo e raccolta aggiornamenti di stato dei dispositivi Shelly da molteplici account utente Shelly. Destinata a casi d'uso B2B e industriali di grandi dimensioni.

• Shelly Fleet Manager - Soluzione SAAS offerta da Shelly o soluzione open source autogestita, indipendente da Shelly Cloud, per la gestione di flotte di dispositivi Shelly.

Il semplice diagramma logico sottostante fornisce una rapida visualizzazione dei concetti spiegati in dettaglio più avanti in questo articolo.

Controllo dei dispositivi da un singolo account Shelly - Cloud Control API

Controllo e Stato tramite HTTP API

Questa è un'API sicura per controllare i dispositivi Shelly tramite Shelly cloud. Con essa puoi eseguire comandi (ma non modificare le impostazioni del dispositivo) e recuperare lo stato del dispositivo, per un singolo account Shelly Cloud.

Può essere usata per casi d'uso base e avanzati e permette di controllare programmaticamente i dispositivi all'interno di un singolo account. La comunicazione avviene tramite HTTPS e lo scambio dati tramite strutture JSON.

Puoi usare il controllo API diretto senza l'app Shelly Control.
Puoi generare una chiave di autorizzazione nell'app in Impostazioni utente->Chiave di autorizzazione cloud
Possedere questa chiave permette il controllo dei dispositivi di un singolo account Shelly.

Nota - La chiave cambierà se cambi la password.

Un account utente è associato a un server nella nostra infrastruttura Shelly cloud che elabora le richieste. Usare questa API richiede di conoscere l'host su cui l'utente è tenant. L'host può cambiare e non è garantito, poiché considerazioni di capacità potrebbero portare a spostare tenant tra host cloud.

Informazioni dettagliate sul controllo a livello di singolo account sono disponibili qui - https://shelly-api-docs.shelly.cloud/cloud-control-api/

Controllo e Eventi in Tempo Reale tramite WebSocket

Caso d'uso - per gestire le API dei dispositivi Shelly per account utente su Shelly cloud. L'autenticazione avviene tramite OAuth.

Questa API è destinata a soluzioni per piccole imprese con basso volume di dispositivi.

API destinata a fornitori di servizi che offrono servizi a valore aggiunto per integrazione a livello di singolo account utente da Shelly Cloud Control. Il token di accesso ha lunga durata ed è invalidato al cambio password.

Connessione: WebSocket viene stabilito usando le credenziali dell'account OAuth. Le notifiche di stato in tempo reale dei dispositivi sono inviate dal cloud Shelly e possono essere emessi anche comandi di controllo dispositivo. L'API permette un modo semplice per un integratore di monitorare gli stati dei dispositivi associati a un singolo account Shelly cloud.

N.B. Ogni connessione di account gestito richiede credenziali OAuth.

Per uso non professionale shelly-diy come client id. I token ottenuti con il client id shelly-diy POTREBBERO essere soggetti a restrizioni di frequenza.

Informazioni dettagliate sono disponibili qui - https://shelly-api-docs.shelly.cloud/cloud-control-api/real-time-events

Controllo dei dispositivi da molteplici account utente Shelly. (Casi d'uso aziendali)

Integrator API

Caso d'uso - per gestire le API dei dispositivi Shelly appartenenti a molteplici account utente su Shelly cloud. Questa API è per soluzioni B2B con grande volume di dispositivi e casi industriali importanti.

Supporta molteplici WebSocket di Eventi in Tempo Reale, aperti da un singolo punto di servizio ed è cloud-to-cloud centric.

Questa è un'API Cloud-to-Cloud per integrazione, controllo e raccolta dati dai nostri dispositivi. È destinata a integratori terzi che vogliono monitorare e controllare dispositivi Shelly connessi ai nostri sistemi cloud. Permette lo streaming centralizzato dei dati di stato da molti account Shelly a un singolo punto per l'ingestione dati. È possibile anche un controllo base sui dispositivi.

Deve essere creato un account integratore che detenga gli endpoint di comunicazione dell'integratore. Per la creazione dell'account integratore e per ottenere una licenza dovresti contattarci a support@shelly.cloud o compilare questo modulo. Le licenze per uso personale non sono fornite e Shelly si riserva il diritto di rifiutare richieste irragionevoli.

Consenso dell'utente - I proprietari dei dispositivi che desiderano utilizzare un servizio devono accedere al loro account Shelly Cloud e concedere il consenso per condividere i loro dispositivi con un integratore. L'ambito del consenso e il consenso stesso possono essere modificati o revocati unilateralmente dall'utente in qualsiasi momento. Il consenso è concesso per dispositivo e può essere solo in lettura o in lettura e controllo.

Informazioni dettagliate sono disponibili qui - https://shelly-api-docs.shelly.cloud/integrator-api/

Soluzione di gestione dispositivi per il controllo di flotte di dispositivi con o senza account Shelly

Shelly Fleet Manager

Caso d'uso - per gestire dispositivi Shelly indipendentemente da Shelly Cloud e dagli account.

Gli obiettivi di Shelly Fleet Manager come prodotto sono monitorare, gestire e controllare flotte di dispositivi smart Shelly in più sedi.

Fornisce una piattaforma centralizzata per acquisizione dati in tempo reale, controllo remoto, automazione e reportistica.

Questi dispositivi possono essere sia associati ad account Shelly Cloud sia no. Questo lo rende molto flessibile, perché puoi aggiungere dispositivi out-of-the-box senza alcuna configurazione e persino aggiungerli in massa con Shelly FMA (Shelly Fleet Manager Assistant).

Shelly Fleet Manager (SFM) è una soluzione SaaS standalone di Shelly ed è completamente indipendente da Shelly Cloud per gli utenti finali. Questa è una soluzione cloud di Shelly che fornisce gestione dispositivi. SFM ha un'interfaccia utente basata su browser (e plugin Chrome) simile ma diversa dall'applicazione Shelly Cloud Control (che è progettata per utenti finali).

SFM è progettato e sviluppato come soluzione back-office per casi in cui è necessario un controller di automazione locale per motivi di sicurezza o richiesti dal design del sistema.

SFM può essere usato come soluzione cloud Shelly o installato come software standalone (è un progetto open source) e ulteriormente sviluppato e personalizzato dai clienti in autonomia.

Con SFM non è necessario un account Shelly Cloud (come per gli utenti regolari) per controllare i dispositivi - è sufficiente connetterli a SFM.

L'onboarding in massa dei dispositivi Shelly è possibile tramite le app mobili Shelly per iOS e Android - Shelly FMA (Shelly Fleet Manager Assistant).

L'app fornisce la messa in servizio dei dispositivi Shelly sull'istanza SFM e aggiunge funzionalità di configurazione e manutenzione per la diagnostica locale.

Scannerizzerà via Bluetooth tutti i nuovi dispositivi nelle vicinanze e li aggiungerà all'istanza SFM preconfigurata. I profili di configurazione possono essere inviati ai dispositivi, permettendo di inserirli in gruppi preconfigurati (basati ad esempio sulla posizione fisica) con impostazioni predefinite, Wi-Fi, ecc.

Google Play Store: https://play.google.com/store/apps/details?id=com.shelly.fleetassistant&hl=en

Apple Store: https://apps.apple.com/bg/app/shelly-fma/id6526479868

Connessione al backend: I dispositivi usano WebSocket in uscita per stabilire la connessione con il Fleet Manager.

Nota: SFM funziona solo con dispositivi Gen2+. Se i dispositivi sono già connessi a Shelly Cloud Control, connetterli a SFM non li disconnetterà dal cloud Shelly, poiché sono connessioni indipendenti.

Informazioni dettagliate sono disponibili qui - https://fleet.shelly.com/

Apprezziamo il tuo feedback!

Grazie per aver dedicato del tempo a leggere il nostro articolo! È stato utile o interessante?

Le tue opinioni possono aiutarci a migliorare. Saremmo grati per qualsiasi feedback. Se hai un momento,

per favore condividilo con noi al seguente indirizzo email:

Integration@shelly.com