Loading...
API de Integración BI
La API de Integración BI proporciona exportaciones de datos aplanados optimizadas para herramientas de Business Intelligence. Accede a datos de dispositivos y activos en un formato fácil de importar en Power BI, Tableau, Excel y otras plataformas de análisis.
URL Base:
https://api.nomid.tech/emm/api/bi/v1¿Por qué una API Separada?
Las herramientas de Business Intelligence a menudo tienen dificultades con estructuras JSON anidadas. La API de BI resuelve esto proporcionando los mismos datos en un formato aplanado.
API Pública (/api/v1)
- DTOs anidados para relaciones de objetos ricas
- Ideal para desarrollo de aplicaciones
- Múltiples niveles de jerarquía de objetos
API BI (/api/bi/v1)
- Todas las propiedades aplanadas al nivel superior
- Mapeo directo de columnas para herramientas BI
- Mismos datos, estructura optimizada
Comparación de Formato de Respuesta
Los mismos datos de activos se devuelven en diferentes formatos dependiendo de qué API uses.
API Pública /api/v1
Estructura Anidadajson
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"syncedAt": "2026-01-29T08:15:00Z",
"customData": {
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_xyz789",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse"
}
}API BI /api/bi/v1
Estructura Aplanadajson
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"lastSyncAt": "2026-01-29T08:15:00Z",
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"],
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung",
"policyPathName": "enterprises/acme/policies/warehouse",
"policyDisplayName": "Warehouse Policy",
"policyGroupName": "Logistics"
}Endpoints Disponibles
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /assets | Listar todos los activos (DTO aplanado) |
| GET | /assets/count | Obtener el conteo total de activos |
| GET | /assets/{assetId} | Obtener un activo específico (DTO aplanado) |
Autenticación
La API de BI usa la misma autenticación por clave API que la API Pública. Incluye tu clave API en el encabezado X-API-Key con cada solicitud.
X-API-Key: nm_acme_abc123...
Casos de Uso Comunes
Dashboards de Power BI
Reportes de Tableau
Conexiones de Datos de Excel
Pipelines de Análisis Personalizados
Comenzar
Consulta la documentación completa del endpoint de Activos BI con ejemplos de código y esquemas de respuesta.
Documentación de Activos BI