PARTE VIntegrazioni
CAPITOLO 14

Token di integrazione e API

Vuoi portare i dati dei tuoi sensori in un sistema tuo, in un foglio di calcolo automatizzato o in un'applicazione partner? Il menu Integrazioni crea token di accesso — chiavi che danno la lettura dei sensori di un dispositivo, senza consegnare il tuo account.

14.1 Creare un token

  1. Nel menu laterale, apri Integrazioni e tocca Aggiungi.
  2. Dai un nome al token — il servizio che lo userà, per esempio.
  3. Se vuoi, imposta una password e una scadenza (fino a 10 anni, oppure senza scadenza).
  4. Scegli il dispositivo — un token dà accesso a un solo dispositivo.
  5. Salva e usa il pulsante Copia per portare il token al servizio di destinazione.

L'elenco mostra i token attivi, con creazione, scadenza e le azioni Modifica e Revoca — revocare taglia l'accesso all'istante, senza intaccare nient'altro.

14.2 L'API dei sensori

Il token dà accesso all'endpoint di lettura del cloud Aquarino:

  • GET cloud.aquarino.com.br/api/integrations/sensors con il token nell'intestazione Authorization: Bearer;
  • La risposta riporta il dispositivo, il firmware e l'elenco dei sensori con valori e unità;
  • Limite di 12 chiamate all'ora per token — la raccomandazione è una chiamata ogni 15 minuti, che segue il ritmo di aggiornamento dei dati.