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 |
| GET | /assets/summary | Obtenga cifras agregadas de la flota: totales, un desglose de estado y un resumen de la postura de seguridad |
| GET | /assets/{id}/commands | Listar los comandos más recientes enviados a un dispositivo |
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: 50, máx.: 100) |
| sort | Campo de ordenación y dirección (ej., syncedAt,desc) |
| lastSeenBefore | Solo activos vistos por última vez antes de este instante ISO-8601, por ejemplo 2026-01-01T00:00:00Z. No debe estar en el futuro ni antes de 1970-01-01T00:00:00Z. También admitido por /assets/count. |
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}Buscar dispositivos no vistos recientemente
lastSeenBefore limita una lista o un recuento a los dispositivos cuyo registro se actualizó por última vez antes del instante indicado, lo que constituye una forma práctica de encontrar dispositivos sin conexión. Funciona con una granularidad de minutos, por lo que un dispositivo actualizado hasta 59 segundos después del instante aún puede incluirse.
curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
-H "X-API-Key: $NOMID_API_KEY" Resumen de la flota
GET /assets/summary requiere DEVICES_READ y devuelve únicamente números agregados, nunca una lista de dispositivos.
| totalDevices | Número total de dispositivos. |
|---|---|
| devicesByStatus | Recuentos de dispositivos clasificados por estado. |
| securityPosture | Recuentos de seguridad como secureCount, atRiskCount y potentiallyCompromisedCount. riskyDeviceIds enumera hasta 10 nombres de ruta de dispositivos, los peores primero. riskyDeviceCount es el total real, y riskyDeviceIdsTruncated indica si la lista se truncó. |
Los recuentos de la postura de seguridad excluyen los dispositivos Pico. El totalDevices de nivel superior no los excluye.
Historial de comandos
GET /assets/ASSET_ID/commands requiere DEVICES_READ y devuelve los comandos más recientes enviados a un dispositivo, los más nuevos primero. limit tiene un valor predeterminado de 20 y tiene un límite de 50. Un limit inferior a 1 devuelve 400, y un activo desconocido devuelve 404.
| type | El tipo de comando, por ejemplo LOCK o NOTIFICATION_MESSAGE. |
|---|---|
| status | IN_PROGRESS, EXPIRED, SUCCESS o ERROR. |
| createdAt | Cuándo se creó el comando. |
| feedbackAt | Cuándo el dispositivo o proveedor emitió el informe, si es que lo hizo. |
| outcome | Un código corto que explica un estado ERROR o EXPIRED. |
curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
-H "X-API-Key: $NOMID_API_KEY" Las cargas útiles de comandos y los datos confidenciales nunca se devuelven.
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 | Identificador único de activo: un código corto como k3x9m2pa, sin barras. Úselo como el ID de activo en las URL, por ejemplo /assets/k3x9m2pa. |
| 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: