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 |
| GET | /assets/summary | Obtenir les chiffres agrégés de la flotte : totaux, ventilation par état et résumé de la posture de sécurité |
| GET | /assets/{id}/commands | Lister les commandes les plus récentes envoyées à un appareil |
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 stratégie attribué |
| page | Numéro de page (indexé sur 0, défaut : 0) |
| size | Taille de page (par défaut : 50, max : 100) |
| sort | Champ de tri et direction (par exemple, syncedAt,desc) |
| lastSeenBefore | Uniquement les actifs vus pour la dernière fois avant cet instant ISO-8601, par exemple 2026-01-01T00:00:00Z. Il ne doit pas être situé dans le futur ni avant le 1970-01-01T00:00:00Z. Également pris en charge par /assets/count. |
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}Trouver les appareils non vus récemment
lastSeenBefore restreint une liste ou un décompte aux appareils dont l'enregistrement a été mis à jour pour la dernière fois avant l'instant indiqué, ce qui est un moyen pratique de trouver les appareils hors ligne. Le filtrage s'effectue à la minute près, de sorte qu'un appareil mis à jour jusqu'à 59 secondes après l'instant peut quand même être inclus.
curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
-H "X-API-Key: $NOMID_API_KEY" Résumé de la flotte
GET /assets/summary nécessite DEVICES_READ et renvoie uniquement des chiffres agrégés, jamais une liste d'appareils.
| totalDevices | Nombre total d'appareils. |
|---|---|
| devicesByStatus | Nombre d'appareils indexé par état. |
| securityPosture | Nombres liés à la sécurité tels que secureCount, atRiskCount et potentiallyCompromisedCount. riskyDeviceIds liste jusqu'à 10 chemins d'appareils, le pire en premier. riskyDeviceCount est le véritable total, et riskyDeviceIdsTruncated indique si la liste a été tronquée. |
Les décomptes de posture de sécurité excluent les appareils Pico. Le champ totalDevices de premier niveau ne les exclut pas.
Historique des commandes
GET /assets/ASSET_ID/commands nécessite DEVICES_READ et renvoie les commandes les plus récentes envoyées à un appareil, de la plus récente à la plus ancienne. limit vaut par défaut 20 et est plafonné à 50. Une limite inférieure à 1 renvoie 400, et un actif inconnu renvoie 404.
| type | Le type de commande, par exemple LOCK ou NOTIFICATION_MESSAGE. |
|---|---|
| status | IN_PROGRESS, EXPIRED, SUCCESS ou ERROR. |
| createdAt | Moment où la commande a été créée. |
| feedbackAt | Date et heure auxquelles l'appareil ou le fournisseur a envoyé un rapport, s'il l'a fait. |
| outcome | Un code court qui explique un statut ERROR ou EXPIRED. |
curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
-H "X-API-Key: $NOMID_API_KEY" Les charges utiles des commandes et les données sensibles ne sont jamais renvoyées.
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 | Identifiant unique de l'actif : un code court tel que k3x9m2pa, sans barres obliques. Utilisez-le comme ID d'actif dans les URL, par exemple /assets/k3x9m2pa. |
| 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 inscrit 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 :