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
- Nel menu laterale, apri Integrazioni e tocca Aggiungi.
- Dai un nome al token — il servizio che lo userà, per esempio.
- Se vuoi, imposta una password e una scadenza (fino a 10 anni, oppure senza scadenza).
- Scegli il dispositivo — un token dà accesso a un solo dispositivo.
- 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/sensorscon il token nell'intestazioneAuthorization: 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.