API d'intégration BI
L'API d'intégration BI fournit des exportations de données aplaties optimisées pour les outils de Business Intelligence. Accédez aux données des appareils et des actifs dans un format facile à importer dans Power BI, Tableau, Excel et d'autres plateformes d'analyse.
https://api.nomid.tech/emm/api/bi/v1Pourquoi une API séparée ?
Les outils de Business Intelligence ont souvent du mal avec les structures JSON imbriquées. L'API BI résout ce problème en fournissant les mêmes données dans un format aplati.
API publique (/api/v1)
- DTO imbriqués pour des relations d'objets riches
- Idéal pour le développement d'applications
- Plusieurs niveaux de hiérarchie d'objets
API BI (/api/bi/v1)
- Toutes les propriétés sont aplaties au premier niveau
- Mappage de colonnes direct pour les outils BI
- Mêmes données, structure optimisée
Comparaison des formats de réponse
Les mêmes données d'actif sont retournées dans différents formats selon l'API que vous utilisez.
API publique /api/v1
{
"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"
}
}API BI /api/bi/v1
{
"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"
}Points de terminaison disponibles
| Méthode | Point de terminaison | Description |
|---|---|---|
| GET | /assets | Lister tous les actifs (DTO aplati) |
| GET | /assets/count | Obtenir le nombre total d'actifs |
| GET | /assets/{assetId} | Obtenir un actif spécifique (DTO aplati) |
Authentification
L'API BI utilise la même authentification par clé API que l'API publique. Incluez votre clé API dans l'en-tête X-API-Key à chaque requête.
Cas d'utilisation courants
Tableaux de bord Power BI
Rapports Tableau
Connexions de données Excel
Pipelines d'analyse personnalisés
Commencer
Consultez la documentation complète du point de terminaison des actifs BI avec des exemples de code et des schémas de réponse.
Documentation des actifs BI