TEIL VIntegrationen
KAPITEL 14

Integrations-Tokens und API

Möchten Sie Ihre Sensordaten in ein eigenes System, eine automatisierte Tabelle oder eine Partner-App bringen? Das Menü Integrations (Integrationen) erzeugt Zugriffstokens — Schlüssel, die Lesezugriff auf die Sensoren eines Geräts gewähren, ohne Ihr Konto herauszugeben.

14.1 Ein Token anlegen

  1. Öffnen Sie im Seitenmenü Integrations und tippen Sie auf Add (Hinzufügen).
  2. Geben Sie dem Token einen Namen — zum Beispiel den des Dienstes, der ihn nutzen wird.
  3. Legen Sie, wenn Sie möchten, ein Passwort und eine Gültigkeit fest (bis zu 10 Jahre oder ohne Ablauf).
  4. Wählen Sie das Gerät — ein Token gewährt Zugriff auf ein einziges Gerät.
  5. Speichern Sie und nutzen Sie die Schaltfläche Copy (Kopieren), um den Token zum Zieldienst zu bringen.

Die Liste zeigt die aktiven Tokens mit Erstellungsdatum, Gültigkeit und den Aktionen Edit (Bearbeiten) und Revoke (Widerrufen) — ein Widerruf kappt den Zugriff sofort, ohne sonst etwas zu beeinträchtigen.

14.2 Die Sensor-API

Der Token gewährt Zugriff auf den Lese-Endpunkt der Aquarino-Cloud:

  • GET cloud.aquarino.com.br/api/integrations/sensors mit dem Token im Header Authorization: Bearer;
  • Die Antwort bringt das Gerät, die Firmware und die Liste der Sensoren mit Werten und Einheiten;
  • Grenze von 12 Aufrufen pro Stunde je Token — empfohlen wird ein Aufruf alle 15 Minuten, was dem Aktualisierungstakt der Daten entspricht.