PARTIE VIntégrations
CHAPITRE 14

Jetons d'intégration et API

Vous voulez emmener les données de vos sondes vers un système à vous, une feuille de calcul automatisée ou une application partenaire ? Le menu Integrations (Intégrations) crée des jetons d'accès — des clés qui donnent un accès en lecture aux sondes d'un équipement, sans livrer votre compte.

14.1 Créer un jeton

  1. Dans le menu latéral, ouvrez Integrations et touchez Add (Ajouter).
  2. Donnez un nom au jeton — le service qui va l'utiliser, par exemple.
  3. Si vous le souhaitez, définissez un mot de passe et une validité (jusqu'à 10 ans, ou sans expiration).
  4. Choisissez l'équipement — un jeton donne accès à un seul équipement.
  5. Enregistrez et utilisez le bouton Copy (Copier) pour emmener le jeton vers le service de destination.

La liste affiche les jetons actifs, avec la date de création, la validité et les actions Edit (Modifier) et Revoke (Révoquer) — révoquer coupe l'accès instantanément, sans rien affecter d'autre.

14.2 L'API des sondes

Le jeton donne accès au point de lecture du cloud Aquarino :

  • GET cloud.aquarino.com.br/api/integrations/sensors avec le jeton dans l'en-tête Authorization: Bearer ;
  • La réponse apporte l'équipement, le firmware et la liste des sondes avec les valeurs et les unités ;
  • Limite de 12 appels par heure par jeton — la recommandation est un appel toutes les 15 minutes, ce qui suit le rythme de mise à jour des données.