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.
Points d'accès disponibles
| Méthode | Point d'accès | Description |
|---|---|---|
| GET | /bi/v1/assets | Lister tous les actifs au format aplati |
| GET | /bi/v1/assets/count | Obtenir le nombre total d'actifs |
| GET | /bi/v1/assets/{id} | Obtenir un actif spécifique par ID |
Lister 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
| status | Filtrer par statut d'actif (par exemple, ACTIF, INACTIF) |
| policy | Filtrer par nom de chemin de politique assigné |
| page | Numéro de page (indexé à partir de 0, par défaut : 0) |
| size | Taille de la page (par défaut : 20, maximum : 100) |
| sort | Champ et direction de tri (par exemple, lastSyncAt,desc) |
curl "https://api.nomid.tech/emm/api/bi/v1/assets?page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."Obtenir le nombre d'actifs
Retourne le nombre total d'actifs correspondant aux critères de filtrage. Utile pour les calculs de pagination.
GET /bi/v1/assets/countObtenir un actif spécifique
Retourne un seul actif dans un format aplati par son ID d'actif.
GET /bi/v1/assets/{id}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.
| Champ | Description |
|---|---|
| pathName | Chemin complet de l'actif (par exemple, entreprises/acme/actifs/abc123) |
| identification | Identifiant convivial pour l'actif |
| name | Nom de l'appareil |
| description | Description de l'appareil |
| serialNumber | Numéro de série de l'appareil |
| imeis | Numéros IMEI (séparés par des virgules si plusieurs) |
| brand | Fabricant/marque de l'appareil |
| model | Nom du modèle de l'appareil |
| status | Statut de l'actif (ACTIF, INACTIF) |
| lastSyncAt | Horodatage de la dernière synchronisation (ISO 8601) |
| enrollmentTime | Horodatage d'enregistrement de l'appareil (ISO 8601) |
| policyPathName | Chemin complet de la politique assignée |
| policyDisplayName | Nom de la politique lisible par l'homme |
| policyGroupName | Groupe de politiques pour la catégorisation |
| metadata | Métadonnées personnalisées sous forme de chaîne JSON |
| tags | Étiquettes sous forme de chaîne séparée par des virgules |
| operatingSystem | Nom du système d'exploitation (par exemple, Android) |
| operatingSystemVersion | 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.
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.