PARTE VIntegrações
CAPÍTULO 14

Tokens de integração e API

Quer levar os dados dos seus sensores para um sistema seu, uma planilha automatizada ou um aplicativo parceiro? O menu Integrações cria tokens de acesso — chaves que dão leitura aos sensores de um equipamento, sem entregar a sua conta.

14.1 Criando um token

  1. No menu lateral, abra Integrações e toque em Adicionar.
  2. Dê um nome ao token — o serviço que vai usá-lo, por exemplo.
  3. Se quiser, defina uma senha e uma validade (até 10 anos, ou sem expiração).
  4. Escolha o equipamento — um token dá acesso a um único equipamento.
  5. Salve e use o botão Copiar para levar o token ao serviço de destino.

A lista mostra os tokens ativos, com criação, validade e as ações de editar e revogar — revogar corta o acesso na hora, sem afetar nada mais.

14.2 A API de sensores

O token dá acesso ao endpoint de leitura da nuvem Aquarino:

  • GET cloud.aquarino.com.br/api/integrations/sensors com o token no cabeçalho Authorization: Bearer;
  • A resposta traz o equipamento, o firmware e a lista de sensores com valores e unidades;
  • Limite de 12 chamadas por hora por token — a recomendação é uma chamada a cada 15 minutos, que acompanha o ritmo de atualização dos dados.