Download von Daten über die API

Die GIoT-Plattform bietet einen sicheren, API-basierten Datenexport, um die Anforderungen des EU Data Act zu erfüllen. Mit dieser Methode können Sie alle Gerätedaten programmgesteuert in einem strukturierten Format abrufen und so eine nahtlose Integration mit Drittsystemen oder die Migration auf andere Plattformen ermöglichen. Folgen Sie den untenstehenden Schritten, um Ihr API-Token zu generieren und sicher auf Ihre Daten zuzugreifen.

Nur Nutzer mit Super-Admin-Rechten oder ausdrücklich erteilten Berechtigungen können auf diesen Bereich zugreifen.

Schritte zum Export von Daten über die API

• Zugriff auf die API-Dokumentation: Öffnen Sie im Cockpit-Menü den Bereich Administration und klicken Sie auf API. Ein neuer Browser-Tab öffnet sich direkt mit Swagger und zeigt die öffentliche GIoT API-Dokumentation.

• Relevanten API-Endpunkt finden: Navigieren Sie durch die strukturierten API-Bereiche, um die Endpunkte für den Datenexport zu finden. Beispiele:

  • Geräte→ Export von Gerätelisten und Konfigurationen

  • Regeln→ Abruf von konfigurierten Regeln und Schwellenwerten

  • Alarme → Download des vollständigen Alarmverlaufs

  • Messungen→ Export gesammelter Messdaten

• API-Methode auswählen: Klicken Sie auf den gewünschten Endpunkt und wählen Sie die GET- oder POST-Methode, abhängig von den Daten, die Sie exportieren möchten.

• Erforderliche Parameter eingeben: Falls der Endpunkt Parameter benötigt (z. B. Tenant-ID, Geräte-ID oder Zeiträume), tragen Sie die erforderlichen Werte in die vorgesehenen Felder ein.

• Anfrage ausführen: Klicken Sie auf „Probieren Sie es aus“, um die API-Anfrage direkt in Swagger auszuführen. Die Daten werden im Response Body darunter angezeigt.

• Daten herunterladen oder speichern: Kopieren Sie die zurückgegebenen Daten oder laden Sie sie im JSON-Format herunter. Bei Bedarf können Sie diese in CSV oder andere Formate umwandeln.

Die API-Endpunkte sind nach Funktionen gruppiert und enthalten detaillierte Beschreibungen als Orientierung. Dies ermöglicht es Ihnen, alle relevanten Informationen — Geräte, Alarme, Messdaten und mehr — direkt aus der Plattform zu exportieren, wie es der EU Data Act vorsieht.