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

GET/api/v1/assets

Lister tous les actifs avec pagination et filtrage

GET/api/v1/assets/count

Obtenir le nombre total d'actifs

GET/api/v1/assets/{assetId}

Obtenir les détails d'un actif spécifique

GET/api/v1/assets

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

Name	Type	Required	Description
`status`	string	Optional	Filtrer par état de l'actif (par exemple, ACTIF, INACTIF)
`policy`	string	Optional	Filtrer par nom de chemin de politique attribué
`page`	integer	Optional	Numéro de page (indexé sur 0, défaut : 0)(default: `0`)
`size`	integer	Optional	Taille de la page (défaut : 20, max : 100)(default: `20`)
`sort`	string	Optional	Champ de tri et direction (par exemple, syncedAt,desc)

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets?status=ACTIVE&page=0&size=20" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "content": [
    {
      "pathName": "enterprises/acme/assets/asset_abc123",
      "identification": "Warehouse Scanner 01",
      "status": "ACTIVE",
      "syncedAt": "2026-01-29T08:15:00Z",
      "customData": {
        "metadata": {
          "department": "logistics",
          "location": "warehouse-a"
        },
        "tags": ["warehouse", "scanner", "critical"]
      },
      "specifications": {
        "imeis": ["123456789012345"],
        "serialNumber": "ABC123XYZ",
        "model": "Galaxy Tab Active3",
        "brand": "Samsung",
        "os": "Android",
        "osVersion": "13"
      },
      "managedDevice": {
        "pathName": "enterprises/acme/devices/device_xyz789",
        "name": "Warehouse Scanner 01",
        "status": "ACTIVE",
        "policyPathName": "enterprises/acme/policies/warehouse",
        "enrollmentTime": "2025-01-15T10:30:00Z"
      }
    }
  ],
  "totalElements": 156,
  "totalPages": 8,
  "size": 20,
  "number": 0
}

GET/api/v1/assets/count

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.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/count?status=ACTIVE" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "count": 156
}

GET/api/v1/assets/{assetId}

Retourne des informations détaillées sur un actif spécifique par son ID, y compris tous les objets imbriqués.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/asset_abc123" \
  -H "X-API-Key: nm_acme_abc123..."

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

Name	Type	Required	Description
`pathName`	string	Required	Chemin complet de l'actif dans la hiérarchie (par exemple, enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Identifiant convivial ou nom d'affichage de l'actif
`status`	string	Required	Statut actuel de l'actif (ACTIF, INACTIF, etc.)
`syncedAt`	string	Required	Horodatage au format ISO 8601 de la dernière synchronisation
`customData`	object	Optional	Objet contenant des métadonnées et des balises personnalisées
`specifications`	object	Optional	Objet contenant les spécifications matérielles
`managedDevice`	object \| null	Optional	Objet contenant les informations de l'appareil EMM, ou null s'il n'est pas inscrit

Objet customData

Name	Type	Required	Description
`metadata`	object	Optional	Paires clé-valeur de métadonnées personnalisées (par exemple, département, emplacement)
`tags`	string[]	Optional	Tableau de chaînes de caractères pour la catégorisation

Objet specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Tableau des numéros IMEI des appareils
`serialNumber`	string	Optional	Numéro de série de l'appareil
`model`	string	Optional	Nom du modèle de l'appareil
`brand`	string	Optional	Fabricant/marque de l'appareil
`os`	string	Optional	Nom du système d'exploitation (par exemple, Android)
`osVersion`	string	Optional	Version du système d'exploitation

Objet managedDevice

Cet objet est null lorsque l'actif n'est pas enregistré en tant qu'appareil géré dans le système EMM.

Name	Type	Required	Description
`pathName`	string	Required	Chemin de l'appareil dans le système EMM
`name`	string	Required	Nom d'affichage de l'appareil dans l'EMM
`status`	string	Required	Statut de l'appareil EMM (ACTIF, PROVISIONNEMENT, DÉSACTIVÉ, etc.)
`policyPathName`	string	Required	Chemin de la politique attribuée
`enrollmentTime`	string	Required	Horodatage ISO 8601 lors de l'enregistrement de l'appareil

Pagination

Les points de terminaison de liste retournent des résultats paginés en utilisant le format Page de Spring :

content - Tableau d'objets d'actifs pour la page actuelle
totalElements - Nombre total d'actifs correspondant à la requête
totalPages - Nombre total de pages disponibles
size - Taille de page demandée
number - Numéro de page actuel (indexé à partir de 0)

Remarque

La taille maximale de page est de 100. Les requêtes avec une taille > 100 seront plafonnées à 100.

Name

Type

Required

Description

status

string

Optional

Filtrer par état de l'actif (par exemple, ACTIF, INACTIF)

policy

string

Optional

Filtrer par nom de chemin de politique attribué

page

integer

Optional

Numéro de page (indexé sur 0, défaut : 0)(default: 0)

size

integer

Optional

Taille de la page (défaut : 20, max : 100)(default: 20)

sort

string

Optional

Champ de tri et direction (par exemple, syncedAt,desc)

{ "content": [ { "pathName": "enterprises/acme/assets/asset_abc123", "identification": "Warehouse Scanner 01", "status": "ACTIVE", "syncedAt": "2026-01-29T08:15:00Z", "customData": { "metadata": { "department": "logistics", "location": "warehouse-a" }, "tags": ["warehouse", "scanner", "critical"] }, "specifications": { "imeis": ["123456789012345"], "serialNumber": "ABC123XYZ", "model": "Galaxy Tab Active3", "brand": "Samsung", "os": "Android", "osVersion": "13" }, "managedDevice": { "pathName": "enterprises/acme/devices/device_xyz789", "name": "Warehouse Scanner 01", "status": "ACTIVE", "policyPathName": "enterprises/acme/policies/warehouse", "enrollmentTime": "2025-01-15T10:30:00Z" } } ], "totalElements": 156, "totalPages": 8, "size": 20, "number": 0 }

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

Name	Type	Required	Description
`pathName`	string	Required	Chemin complet de l'actif dans la hiérarchie (par exemple, enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Identifiant convivial ou nom d'affichage de l'actif
`status`	string	Required	Statut actuel de l'actif (ACTIF, INACTIF, etc.)
`syncedAt`	string	Required	Horodatage au format ISO 8601 de la dernière synchronisation
`customData`	object	Optional	Objet contenant des métadonnées et des balises personnalisées
`specifications`	object	Optional	Objet contenant les spécifications matérielles
`managedDevice`	object \| null	Optional	Objet contenant les informations de l'appareil EMM, ou null s'il n'est pas inscrit

Objet customData

Name	Type	Required	Description
`metadata`	object	Optional	Paires clé-valeur de métadonnées personnalisées (par exemple, département, emplacement)
`tags`	string[]	Optional	Tableau de chaînes de caractères pour la catégorisation

Objet specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Tableau des numéros IMEI des appareils
`serialNumber`	string	Optional	Numéro de série de l'appareil
`model`	string	Optional	Nom du modèle de l'appareil
`brand`	string	Optional	Fabricant/marque de l'appareil
`os`	string	Optional	Nom du système d'exploitation (par exemple, Android)
`osVersion`	string	Optional	Version du système d'exploitation

Objet managedDevice

Cet objet est null lorsque l'actif n'est pas enregistré en tant qu'appareil géré dans le système EMM.

Name	Type	Required	Description
`pathName`	string	Required	Chemin de l'appareil dans le système EMM
`name`	string	Required	Nom d'affichage de l'appareil dans l'EMM
`status`	string	Required	Statut de l'appareil EMM (ACTIF, PROVISIONNEMENT, DÉSACTIVÉ, etc.)
`policyPathName`	string	Required	Chemin de la politique attribuée
`enrollmentTime`	string	Required	Horodatage ISO 8601 lors de l'enregistrement de l'appareil

Pagination

Les points de terminaison de liste retournent des résultats paginés en utilisant le format Page de Spring :

content - Tableau d'objets d'actifs pour la page actuelle

totalElements - Nombre total d'actifs correspondant à la requête

totalPages - Nombre total de pages disponibles

size - Taille de page demandée

number - Numéro de page actuel (indexé à partir de 0)

Remarque

La taille maximale de page est de 100. Les requêtes avec une taille > 100 seront plafonnées à 100.