PART VIntegrations
CHAPTER 14

Integration tokens and API

Want to take your sensor data to a system of your own, an automated spreadsheet or a partner app? The Integrations menu creates access tokens — keys that grant read access to one piece of equipment's sensors, without handing over your account.

14.1 Creating a token

  1. In the side menu, open Integrations and tap Add.
  2. Give the token a name — the service that will use it, for example.
  3. If you want, set a password and an expiry (up to 10 years, or no expiration).
  4. Choose the equipment — one token grants access to a single piece of equipment.
  5. Save and use the Copy button to take the token to the destination service.

The list shows the active tokens, with creation date, expiry and the edit and revoke actions — revoking cuts the access instantly, without affecting anything else.

14.2 The sensor API

The token grants access to the Aquarino cloud's read endpoint:

  • GET cloud.aquarino.com.br/api/integrations/sensors with the token in the Authorization: Bearer header;
  • The response brings the equipment, the firmware and the list of sensors with values and units;
  • Limit of 12 calls per hour per token — the recommendation is one call every 15 minutes, which matches the data refresh pace.