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

GET/api/v1/assets

Listar todos los activos con paginación y filtros

GET/api/v1/assets/count

Obtener el conteo total de activos

GET/api/v1/assets/{assetId}

Obtener detalles de un activo específico

GET/api/v1/assets

Devuelve una lista paginada de activos con filtros opcionales. Los resultados se ordenan por syncedAt descendente por defecto.

Parámetros de Consulta

Name	Type	Required	Description
`status`	string	Optional	Filtrar por estado del activo (ej., ACTIVE, INACTIVE)
`policy`	string	Optional	Filtrar por nombre de ruta de política asignada
`page`	integer	Optional	Número de página (indexado desde 0, predeterminado: 0)(default: `0`)
`size`	integer	Optional	Tamaño de página (predeterminado: 20, máximo: 100)(default: `20`)
`sort`	string	Optional	Campo de ordenación y dirección (ej., 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

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.

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}

Devuelve información detallada sobre un activo específico por su ID, incluyendo todos los objetos anidados.

Request

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

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

Name	Type	Required	Description
`pathName`	string	Required	Ruta completa del activo en la jerarquía (ej., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Identificador amigable o nombre de visualización del activo
`status`	string	Required	Estado actual del activo (ACTIVE, INACTIVE, etc.)
`syncedAt`	string	Required	Marca de tiempo ISO 8601 de la última sincronización
`customData`	object	Optional	Objeto que contiene metadatos personalizados y etiquetas
`specifications`	object	Optional	Objeto que contiene especificaciones de hardware
`managedDevice`	object \| null	Optional	Objeto que contiene información del dispositivo EMM, o null si no está inscrito

Objeto customData

Name	Type	Required	Description
`metadata`	object	Optional	Pares clave-valor de metadatos personalizados (ej., departamento, ubicación)
`tags`	string[]	Optional	Array de etiquetas de texto para categorización

Objeto specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Array de números IMEI del dispositivo
`serialNumber`	string	Optional	Número de serie del dispositivo
`model`	string	Optional	Nombre del modelo del dispositivo
`brand`	string	Optional	Fabricante/marca del dispositivo
`os`	string	Optional	Nombre del sistema operativo (ej., Android)
`osVersion`	string	Optional	Versión del sistema operativo

Objeto managedDevice

Este objeto es null cuando el activo no está inscrito como dispositivo gestionado en el sistema EMM.

Name	Type	Required	Description
`pathName`	string	Required	Ruta del dispositivo en el sistema EMM
`name`	string	Required	Nombre de visualización del dispositivo en EMM
`status`	string	Required	Estado del dispositivo EMM (ACTIVE, PROVISIONING, DISABLED, etc.)
`policyPathName`	string	Required	Ruta de la política asignada
`enrollmentTime`	string	Required	Marca de tiempo ISO 8601 cuando el dispositivo fue inscrito

Paginación

Los endpoints de listado devuelven resultados paginados usando el formato Page de Spring:

content - Array de objetos de activo para la página actual
totalElements - Número total de activos que coinciden con la consulta
totalPages - Número total de páginas disponibles
size - Tamaño de página solicitado
number - Número de página actual (indexado desde 0)

Nota

El tamaño máximo de página es 100. Las solicitudes con size > 100 se limitarán a 100.

Name

Type

Required

Description

status

string

Optional

Filtrar por estado del activo (ej., ACTIVE, INACTIVE)

policy

string

Optional

Filtrar por nombre de ruta de política asignada

page

integer

Optional

Número de página (indexado desde 0, predeterminado: 0)(default: 0)

size

integer

Optional

Tamaño de página (predeterminado: 20, máximo: 100)(default: 20)

sort

string

Optional

Campo de ordenación y dirección (ej., 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 }

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

Name	Type	Required	Description
`pathName`	string	Required	Ruta completa del activo en la jerarquía (ej., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Identificador amigable o nombre de visualización del activo
`status`	string	Required	Estado actual del activo (ACTIVE, INACTIVE, etc.)
`syncedAt`	string	Required	Marca de tiempo ISO 8601 de la última sincronización
`customData`	object	Optional	Objeto que contiene metadatos personalizados y etiquetas
`specifications`	object	Optional	Objeto que contiene especificaciones de hardware
`managedDevice`	object \| null	Optional	Objeto que contiene información del dispositivo EMM, o null si no está inscrito

Objeto customData

Name	Type	Required	Description
`metadata`	object	Optional	Pares clave-valor de metadatos personalizados (ej., departamento, ubicación)
`tags`	string[]	Optional	Array de etiquetas de texto para categorización

Objeto specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Array de números IMEI del dispositivo
`serialNumber`	string	Optional	Número de serie del dispositivo
`model`	string	Optional	Nombre del modelo del dispositivo
`brand`	string	Optional	Fabricante/marca del dispositivo
`os`	string	Optional	Nombre del sistema operativo (ej., Android)
`osVersion`	string	Optional	Versión del sistema operativo

Objeto managedDevice

Este objeto es null cuando el activo no está inscrito como dispositivo gestionado en el sistema EMM.

Name	Type	Required	Description
`pathName`	string	Required	Ruta del dispositivo en el sistema EMM
`name`	string	Required	Nombre de visualización del dispositivo en EMM
`status`	string	Required	Estado del dispositivo EMM (ACTIVE, PROVISIONING, DISABLED, etc.)
`policyPathName`	string	Required	Ruta de la política asignada
`enrollmentTime`	string	Required	Marca de tiempo ISO 8601 cuando el dispositivo fue inscrito

Paginación

Los endpoints de listado devuelven resultados paginados usando el formato Page de Spring:

content - Array de objetos de activo para la página actual

totalElements - Número total de activos que coinciden con la consulta

totalPages - Número total de páginas disponibles

size - Tamaño de página solicitado

number - Número de página actual (indexado desde 0)

Nota

El tamaño máximo de página es 100. Las solicitudes con size > 100 se limitarán a 100.