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
- No menu lateral, abra Integrações e toque em Adicionar.
- Dê um nome ao token — o serviço que vai usá-lo, por exemplo.
- Se quiser, defina uma senha e uma validade (até 10 anos, ou sem expiração).
- Escolha o equipamento — um token dá acesso a um único equipamento.
- 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/sensorscom o token no cabeçalhoAuthorization: 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.