Loading...
Point de terminaison des actifs BI
Accédez aux données d'actifs dans un format aplati optimisé pour les outils de Business Intelligence. Tous les champs sont au niveau racine pour un mappage direct des colonnes.
Différence clé par rapport à l'API publique
L'API BI renvoie une structure complètement aplatie - pas d'objets imbriqués. Cela la rend parfaite pour les outils qui attendent des données tabulaires :
- •Tous les champs sont de premier niveau (pas d'imbrication)
- •Les tableaux sont convertis en chaînes séparées par des virgules
- •Les objets sont sérialisés en chaînes JSON
Points d'accès disponibles
| Méthode | Point d'accès | Description |
|---|---|---|
| GET | /api/bi/v1/assets | Lister tous les actifs au format aplati |
| GET | /api/bi/v1/assets/count | Obtenir le nombre total d'actifs |
| GET | /api/bi/v1/assets/{assetId} | Obtenir un actif spécifique par ID |
GET
/assetsLister tous les actifs
Retourne une liste paginée d'actifs avec tous les champs aplatis au niveau racine. Idéal pour l'exportation de données en masse vers des outils de BI.
Paramètres de requête
| Parameter | Type | Description |
|---|---|---|
| status | string | Filtrer par statut d'actif (par exemple, ACTIF, INACTIF) |
| policy | string | Filtrer par nom de chemin de politique assigné |
| page | integer | Numéro de page (indexé à partir de 0, par défaut : 0) |
| size | integer | Taille de la page (par défaut : 20, maximum : 100) |
| sort | string | Champ et direction de tri (par exemple, lastSyncAt,desc) |
Request
curl -X GET "https://api.nomid.tech/emm/api/bi/v1/assets?status=ACTIVE&page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."Responsejson
{
"content": [
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"name": "WH-SCANNER-001",
"description": "Main warehouse barcode scanner",
"serialNumber": "ABC123XYZ",
"imeis": "123456789012345",
"brand": "Samsung",
"model": "Galaxy Tab Active3",
"status": "ACTIVE",
"lastSyncAt": "2026-01-29T08:15:00Z",
"enrollmentTime": "2025-01-15T10:30:00Z",
"policyPathName": "enterprises/acme/policies/warehouse",
"policyDisplayName": "Warehouse Policy",
"policyGroupName": "Warehouse",
"metadata": "{\"department\":\"logistics\",\"location\":\"warehouse-a\"}",
"tags": "warehouse,scanner,critical",
"operatingSystem": "Android",
"operatingSystemVersion": "13"
}
],
"totalElements": 156,
"totalPages": 2,
"size": 100,
"number": 0
}GET
/assets/countObtenir le nombre d'actifs
Retourne le nombre total d'actifs correspondant aux critères de filtrage. Utile pour les calculs de pagination.
Requestbash
curl -X GET "https://api.nomid.tech/emm/api/bi/v1/assets/count?status=ACTIVE" \
-H "X-API-Key: nm_acme_abc123..."Responsejson
{
"count": 156
}GET
/assets/{assetId}Obtenir un actif spécifique
Retourne un seul actif dans un format aplati par son ID d'actif.
Requestbash
curl -X GET "https://api.nomid.tech/emm/api/bi/v1/assets/asset_abc123" \
-H "X-API-Key: nm_acme_abc123..."Schéma BiAssetDto
Chaque objet actif suit la structure aplatie BiAssetDto. Tous les champs sont des chaînes de caractères au niveau racine - pas d'objets imbriqués ni de tableaux.
| Field | Type | Description |
|---|---|---|
| Identifiants | ||
| pathName | string | Chemin complet de l'actif (par exemple, entreprises/acme/actifs/abc123) |
| identification | string | Identifiant convivial pour l'actif |
| name | string | Nom de l'appareil |
| description | string | Description de l'appareil |
| Infos Matériel | ||
| serialNumber | string | Numéro de série de l'appareil |
| imeis | string | Numéros IMEI (séparés par des virgules si plusieurs) |
| brand | string | Fabricant/marque de l'appareil |
| model | string | Nom du modèle de l'appareil |
| Statut et Horodatages | ||
| status | string | Statut de l'actif (ACTIF, INACTIF) |
| lastSyncAt | string | Horodatage de la dernière synchronisation (ISO 8601) |
| enrollmentTime | string | Horodatage d'enregistrement de l'appareil (ISO 8601) |
| Informations sur la politique | ||
| policyPathName | string | Chemin complet de la politique assignée |
| policyDisplayName | string | Nom de la politique lisible par l'homme |
| policyGroupName | string | Groupe de politiques pour la catégorisation |
| Données personnalisées | ||
| metadata | string | Métadonnées personnalisées sous forme de chaîne JSON |
| tags | string | Étiquettes sous forme de chaîne séparée par des virgules |
| Système d'exploitation | ||
| operatingSystem | string | Nom du système d'exploitation (par exemple, Android) |
| operatingSystemVersion | string | Numéro de version de l'OS |
API publique vs API BI
La principale différence réside dans la structure de la réponse. L'API publique utilise des objets imbriqués pour l'organisation, tandis que l'API BI aplatit tout pour faciliter la correspondance des colonnes.
API publique (imbriquée)
// Public API Response (nested)
{
"pathName": "enterprises/acme/assets/abc123",
"customData": {
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"brand": "Samsung"
},
"managedDevice": {
"policyPathName": "enterprises/acme/policies/warehouse"
}
}API BI (plate)
// BI API Response (flat)
{
"pathName": "enterprises/acme/assets/abc123",
"metadata": "{\"department\":\"logistics\"}",
"tags": "warehouse,scanner",
"imeis": "123456789012345",
"serialNumber": "ABC123XYZ",
"brand": "Samsung",
"policyPathName": "enterprises/acme/policies/warehouse"
}Pagination
Les résultats sont paginés en utilisant le même format que l'API publique. Utilisez les paramètres page et size pour naviguer dans de grands ensembles de données.
Astuce: Pour les exportations en masse, utilisez size=100 (maximum) et parcourez toutes les pages. Les exemples Power BI et Python ci-dessus montrent comment récupérer toutes les pages automatiquement.