Loading...
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.
Basis-URL:
https://api.nomid.tech/emm/api/bi/v1Warum 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 /api/v1
Verschachtelte Strukturjson
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"syncedAt": "2026-01-29T08:15:00Z",
"customData": {
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_xyz789",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse"
}
}BI-API /api/bi/v1
Abgeflachte Strukturjson
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"lastSyncAt": "2026-01-29T08:15:00Z",
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"],
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung",
"policyPathName": "enterprises/acme/policies/warehouse",
"policyDisplayName": "Warehouse Policy",
"policyGroupName": "Logistics"
}Verfügbare Endpunkte
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| GET | /assets | Alle Assets auflisten (abgeflachte DTO) |
| GET | /assets/count | Gesamtanzahl der Assets abrufen |
| GET | /assets/{assetId} | 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_abc123...
Gängige Anwendungsfälle
Power BI Dashboards
Tableau Berichte
Excel-Datenverbindungen
Benutzerdefinierte Analyse-Pipelines
Erste Schritte
Sehen Sie die vollständige Dokumentation des BI Assets-Endpunkts mit Codebeispielen und Antwortschemata.
BI Assets Dokumentation