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étodoEndpointDescripción
GET/assetsListar todos los activos con paginación y filtros
GET/assets/countObtener el conteo total de activos
GET/assets/{id}Obtener detalles de un activo específico
GET/assets/summaryObtenga cifras agregadas de la flota: totales, un desglose de estado y un resumen de la postura de seguridad
GET/assets/{id}/commandsListar 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

CampoDescripción
statusFiltrar por estado del activo (ej., ACTIVE, INACTIVE)
policyFiltrar por nombre de ruta de política asignada
pageNúmero de página (indexado desde 0, predeterminado: 0)
sizeTamaño de página (predeterminado: 50, máx.: 100)
sortCampo de ordenación y dirección (ej., syncedAt,desc)
lastSeenBeforeSolo 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/count

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

totalDevicesNúmero total de dispositivos.
devicesByStatusRecuentos de dispositivos clasificados por estado.
securityPostureRecuentos 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.

typeEl tipo de comando, por ejemplo LOCK o NOTIFICATION_MESSAGE.
statusIN_PROGRESS, EXPIRED, SUCCESS o ERROR.
createdAtCuándo se creó el comando.
feedbackAtCuándo el dispositivo o proveedor emitió el informe, si es que lo hizo.
outcomeUn 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.

Enviar comandos con la API de comandos de dispositivos

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

pathNameIdentificador único de activo: un código corto como k3x9m2pa, sin barras. Úselo como el ID de activo en las URL, por ejemplo /assets/k3x9m2pa.
identificationIdentificador amigable o nombre de visualización del activo
statusEstado actual del activo (ACTIVE, INACTIVE, etc.)
syncedAtMarca de tiempo ISO 8601 de la última sincronización
customDataObjeto que contiene metadatos personalizados y etiquetas
specificationsObjeto que contiene especificaciones de hardware
managedDeviceObjeto 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:

Elija su horario

Cargando...
Abrir el calendario de reservas