NomidAPI de Integração de BI
A API de Integração de BI fornece exportações de dados aplanados otimizadas para ferramentas de Business Intelligence. Aceda a dados de dispositivos e ativos num formato fácil de importar para o Power BI, Tableau, Excel e outras plataformas de análise.
Porquê uma API Separada?
As ferramentas de Business Intelligence têm frequentemente dificuldades com estruturas JSON aninhadas. A API de BI resolve este problema ao fornecer os mesmos dados num formato aplanado.
API Pública (/api/v1)
- DTOs aninhados para relações complexas entre objetos
- Ideal para o desenvolvimento de aplicações
- Múltiplos níveis de hierarquia de objetos
API de BI (/api/bi/v1)
- Todas as propriedades aplanadas para o nível superior
- Mapeamento direto de colunas para ferramentas de BI
- Os mesmos dados, estrutura otimizada
Comparação de Formatos de Resposta
Os mesmos dados de ativos são devolvidos em formatos diferentes consoante a API utilizada.
API Pública
Estrutura Aninhada
API de BI
Estrutura Aplanada
Endpoints Disponíveis
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /bi/v1/assets | Listar todos os ativos (DTO aplanado) |
| GET | /bi/v1/assets/count | Obter a contagem total de ativos |
| GET | /bi/v1/assets/{id} | Obter um ativo específico (DTO aplanado) |
Autenticação
A API de BI utiliza a mesma autenticação por chave de API que a API Pública. Inclua a sua chave de API no cabeçalho X-API-Key em cada pedido.
X-API-Key: nm_acme_a1b2c3d4e5f6...Casos de Uso Comuns
Começar
Consulte a documentação completa do endpoint de Ativos de BI com exemplos de código e esquemas de resposta.
Documentação de Ativos de BI