API de Activos
Endpoints para acceder a información de activos en tu organización. Los activos representan elementos de inventario que pueden o no estar inscritos como dispositivos gestionados.
Endpoints Disponibles
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /assets | Listar todos los activos con paginación y filtros |
| GET | /assets/count | Obtener el conteo total de activos |
| GET | /assets/{id} | Obtener detalles de un activo específico |
Listar Activos
Devuelve una lista paginada de activos con filtros opcionales. Los resultados se ordenan por syncedAt descendente por defecto.
Parámetros de Consulta
| Campo | Descripción |
|---|---|
| status | Filtrar por estado del activo (ej., ACTIVE, INACTIVE) |
| policy | Filtrar por nombre de ruta de política asignada |
| page | Número de página (indexado desde 0, predeterminado: 0) |
| size | Tamaño de página (predeterminado: 20, máximo: 100) |
| sort | Campo de ordenación y dirección (ej., syncedAt,desc) |
curl "https://api.nomid.tech/emm/api/v1/assets?page=0&size=20" \
-H "X-API-Key: nm_acme_abc123..."Obtener Conteo de Activos
Devuelve el conteo total de activos que coinciden con los criterios de filtro. Soporta los mismos parámetros de filtro que el endpoint de listado.
GET /assets/countObtener Activo
Devuelve información detallada sobre un activo específico por su ID, incluyendo todos los objetos anidados.
GET /assets/{id}Esquema de Respuesta
Cada objeto de activo sigue la estructura PublicAssetDto con objetos anidados para datos personalizados, especificaciones de hardware e información del dispositivo gestionado.
Campos de Nivel Superior
| pathName | Ruta completa del activo en la jerarquía (ej., enterprises/acme/assets/asset_abc123) |
| identification | Identificador amigable o nombre de visualización del activo |
| status | Estado actual del activo (ACTIVE, INACTIVE, etc.) |
| syncedAt | Marca de tiempo ISO 8601 de la última sincronización |
| customData | Objeto que contiene metadatos personalizados y etiquetas |
| specifications | Objeto que contiene especificaciones de hardware |
| managedDevice | Objeto que contiene información del dispositivo EMM, o null si no está inscrito |
Objeto customData
Pares clave-valor de metadatos personalizados (ej., departamento, ubicación)
Array de etiquetas de texto para categorización
Objeto specifications
Número de serie del dispositivo
Nombre del modelo del dispositivo
Objeto managedDevice
Este objeto es null cuando el activo no está inscrito como dispositivo gestionado en el sistema EMM.
Paginación
Los endpoints de listado devuelven resultados paginados usando el formato Page de Spring: