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éthodePoint de terminaisonDescription
GET/assetsLister tous les actifs avec pagination et filtrage
GET/assets/countObtenir le nombre total d'actifs
GET/assets/{id}Obtenir les détails d'un actif spécifique
GET/assets/summaryObtenir les chiffres agrégés de la flotte : totaux, ventilation par état et résumé de la posture de sécurité
GET/assets/{id}/commandsLister 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

ChampDescription
statusFiltrer par état de l'actif (par exemple, ACTIF, INACTIF)
policyFiltrer par nom de chemin de stratégie attribué
pageNuméro de page (indexé sur 0, défaut : 0)
sizeTaille de page (par défaut : 50, max : 100)
sortChamp de tri et direction (par exemple, syncedAt,desc)
lastSeenBeforeUniquement 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/count

Obtenir 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.

totalDevicesNombre total d'appareils.
devicesByStatusNombre d'appareils indexé par état.
securityPostureNombres 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.

typeLe type de commande, par exemple LOCK ou NOTIFICATION_MESSAGE.
statusIN_PROGRESS, EXPIRED, SUCCESS ou ERROR.
createdAtMoment où la commande a été créée.
feedbackAtDate et heure auxquelles l'appareil ou le fournisseur a envoyé un rapport, s'il l'a fait.
outcomeUn 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.

Envoyer des commandes avec l'API des commandes d'appareils

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

pathNameIdentifiant 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.
identificationIdentifiant convivial ou nom d'affichage de l'actif
statusStatut actuel de l'actif (ACTIF, INACTIF, etc.)
syncedAtHorodatage au format ISO 8601 de la dernière synchronisation
customDataObjet contenant des métadonnées et des balises personnalisées
specificationsObjet contenant les spécifications matérielles
managedDeviceObjet 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 :

Choisissez votre horaire

Chargement...
Ouvrir le calendrier de réservation