API de Integração BI
A API de Integração BI fornece exportações de dados simplificados otimizadas para ferramentas de Business Intelligence. Acesse dados de dispositivos e ativos em um formato fácil de importar no Power BI, Tableau, Excel e outras plataformas de análise.
https://api.nomid.tech/emm/api/bi/v1Por que uma API Separada?
Ferramentas de Business Intelligence frequentemente têm dificuldades com estruturas JSON aninhadas. A API de BI resolve isso fornecendo os mesmos dados em um formato simplificado.
API Pública (/api/v1)
- DTOs aninhados para relações de objetos ricas
- Ideal para desenvolvimento de aplicações
- Múltiplos níveis de hierarquia de objetos
API BI (/api/bi/v1)
- Todas as propriedades simplificadas no nível superior
- Mapeamento direto de colunas para ferramentas BI
- Mesmos dados, estrutura otimizada
Comparação de Formato de Resposta
Os mesmos dados de ativos são retornados em diferentes formatos dependendo de qual API você usa.
API Pública /api/v1
{
"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
{
"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 Disponíveis
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /assets | Listar todos os ativos (DTO simplificado) |
| GET | /assets/count | Obter contagem total de ativos |
| GET | /assets/{assetId} | Obter um ativo específico (DTO simplificado) |
Autenticação
A API de BI usa a mesma autenticação por chave de API que a API Pública. Inclua sua chave de API no cabeçalho X-API-Key com cada solicitação.
Casos de Uso Comuns
Dashboards do Power BI
Relatórios do Tableau
Conexões de Dados do Excel
Pipelines de Análise Personalizados
Começar
Consulte a documentação completa do endpoint de Ativos BI com exemplos de código e esquemas de resposta.
Documentação de Ativos BI