API des actifs
Points de terminaison pour accéder aux informations sur les actifs de votre organisation. Les actifs représentent des éléments d'inventaire qui peuvent ou non être inscrits en tant qu'appareils gérés.
Points de terminaison disponibles
| Méthode | Point de terminaison | Description |
|---|---|---|
| GET | /assets | Lister tous les actifs avec pagination et filtrage |
| GET | /assets/count | Obtenir le nombre total d'actifs |
| GET | /assets/{id} | Obtenir les détails d'un actif spécifique |
Lister les actifs
Renvoie une liste paginée d'actifs avec un filtrage optionnel. Les résultats sont triés par syncedAt décroissant par défaut.
Paramètres de requête
| Champ | Description |
|---|---|
| status | Filtrer par état de l'actif (par exemple, ACTIF, INACTIF) |
| policy | Filtrer par nom de chemin de politique attribué |
| page | Numéro de page (indexé sur 0, défaut : 0) |
| size | Taille de la page (défaut : 20, max : 100) |
| sort | Champ de tri et direction (par exemple, syncedAt,desc) |
curl "https://api.nomid.tech/emm/api/v1/assets?page=0&size=20" \
-H "X-API-Key: nm_acme_abc123..."Obtenir le nombre d'actifs
Retourne le nombre total d'actifs correspondant aux critères de filtrage. Prend en charge les mêmes paramètres de filtre que le point de terminaison de liste.
GET /assets/countObtenir un actif
Retourne des informations détaillées sur un actif spécifique par son ID, y compris tous les objets imbriqués.
GET /assets/{id}Schéma de réponse
Chaque objet d'actif suit la structure PublicAssetDto avec des objets imbriqués pour les données personnalisées, les spécifications matérielles et les informations sur les appareils gérés.
Champs de niveau supérieur
| pathName | Chemin complet de l'actif dans la hiérarchie (par exemple, enterprises/acme/assets/asset_abc123) |
| identification | Identifiant convivial ou nom d'affichage de l'actif |
| status | Statut actuel de l'actif (ACTIF, INACTIF, etc.) |
| syncedAt | Horodatage au format ISO 8601 de la dernière synchronisation |
| customData | Objet contenant des métadonnées et des balises personnalisées |
| specifications | Objet contenant les spécifications matérielles |
| managedDevice | Objet contenant les informations de l'appareil EMM, ou null s'il n'est pas inscrit |
Objet customData
Paires clé-valeur de métadonnées personnalisées (par exemple, département, emplacement)
Tableau de chaînes de caractères pour la catégorisation
Objet specifications
Numéro de série de l'appareil
Nom du modèle de l'appareil
Objet managedDevice
Cet objet est null lorsque l'actif n'est pas enregistré en tant qu'appareil géré dans le système EMM.
Pagination
Les points de terminaison de liste retournent des résultats paginés en utilisant le format Page de Spring :