BI-Integrations-API
Die BI-Integrations-API bietet abgeflachte Datenexporte, die für Business-Intelligence-Tools optimiert sind. Greifen Sie auf Geräte- und Asset-Daten in einem Format zu, das sich leicht in Power BI, Tableau, Excel und andere Analyseplattformen importieren lässt.
Warum eine separate API?
Business-Intelligence-Tools haben oft Schwierigkeiten mit verschachtelten JSON-Strukturen. Die BI-API löst dieses Problem, indem sie dieselben Daten in einem abgeflachten Format bereitstellt.
Öffentliche API (/api/v1)
- Verschachtelte DTOs für reiche Objektbeziehungen
- Ideal für die Anwendungsentwicklung
- Mehrere Ebenen der Objekthierarchie
BI-API (/api/bi/v1)
- Alle Eigenschaften auf die oberste Ebene abgeflacht
- Direkte Spaltenzuordnung für BI-Tools
- Gleiche Daten, optimierte Struktur
Vergleich der Antwortformate
Die gleichen Asset-Daten werden je nach verwendeter API in unterschiedlichen Formaten zurückgegeben.
Öffentliche API
Verschachtelte Struktur
BI-API
Abgeflachte Struktur
Verfügbare Endpunkte
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| GET | /bi/v1/assets | Alle Assets auflisten (abgeflachte DTO) |
| GET | /bi/v1/assets/count | Gesamtanzahl der Assets abrufen |
| GET | /bi/v1/assets/{id} | Ein bestimmtes Asset abrufen (abgeflachte DTO) |
Authentifizierung
Die BI-API verwendet die gleiche API-Schlüssel-Authentifizierung wie die Public-API. Fügen Sie Ihren API-Schlüssel bei jeder Anfrage im X-API-Key-Header hinzu.
X-API-Key: nm_acme_a1b2c3d4e5f6...Gängige Anwendungsfälle
Erste Schritte
Sehen Sie die vollständige Dokumentation des BI Assets-Endpunkts mit Codebeispielen und Antwortschemata.
BI Assets Dokumentation