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.
Por 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
Estrutura Aninhada
API BI
Estrutura Simplificada
Endpoints Disponíveis
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /bi/v1/assets | Listar todos os ativos (DTO simplificado) |
| GET | /bi/v1/assets/count | Obter contagem total de ativos |
| GET | /bi/v1/assets/{id} | 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.
X-API-Key: nm_acme_a1b2c3d4e5f6...Casos de Uso Comuns
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