Endpoint de Activos BI
Accede a datos de activos en un formato aplanado optimizado para herramientas de Business Intelligence. Todos los campos están en el nivel raíz para mapeo directo de columnas.
Endpoints Disponibles
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /bi/v1/assets | Listar todos los activos en formato aplanado |
| GET | /bi/v1/assets/count | Obtener el conteo total de activos |
| GET | /bi/v1/assets/{id} | Obtener un activo específico por ID |
Listar Todos los Activos
Devuelve una lista paginada de activos con todos los campos aplanados al nivel raíz. Ideal para exportación masiva de datos a herramientas BI.
Parámetros de Consulta
| 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., lastSyncAt,desc) |
curl "https://api.nomid.tech/emm/api/bi/v1/assets?page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."Obtener Conteo de Activos
Devuelve el conteo total de activos que coinciden con los criterios de filtro. Útil para cálculos de paginación.
GET /bi/v1/assets/countObtener Activo Específico
Devuelve un único activo en formato aplanado por su ID de activo.
GET /bi/v1/assets/{id}Esquema BiAssetDto
Cada objeto de activo sigue la estructura plana BiAssetDto. Todos los campos son cadenas en el nivel raíz - sin objetos anidados ni arrays.
| Campo | Descripción |
|---|---|
| pathName | Ruta completa del activo (ej., enterprises/acme/assets/abc123) |
| identification | Identificador amigable del activo |
| name | Nombre del dispositivo |
| description | Descripción del dispositivo |
| serialNumber | Número de serie del dispositivo |
| imeis | Números IMEI (separados por comas si hay múltiples) |
| brand | Fabricante/marca del dispositivo |
| model | Nombre del modelo del dispositivo |
| status | Estado del activo (ACTIVE, INACTIVE) |
| lastSyncAt | Marca de tiempo de última sincronización (ISO 8601) |
| enrollmentTime | Marca de tiempo de inscripción del dispositivo (ISO 8601) |
| policyPathName | Ruta completa de la política asignada |
| policyDisplayName | Nombre legible de la política |
| policyGroupName | Grupo de política para categorización |
| metadata | Metadatos personalizados como cadena JSON |
| tags | Etiquetas como cadena separada por comas |
| operatingSystem | Nombre del SO (ej., Android) |
| operatingSystemVersion | Número de versión del SO |
API Pública vs API BI
La principal diferencia es la estructura de respuesta. La API Pública usa objetos anidados para organización, mientras que la API BI aplana todo para mapeo fácil de columnas.
Paginación
Los resultados están paginados usando el mismo formato que la API Pública. Usa los parámetros page y size para navegar por grandes conjuntos de datos.