Endpoint de Ativos BI
Acesse dados de ativos em formato simplificado otimizado para ferramentas de Business Intelligence. Todos os campos estão no nível raiz para mapeamento direto de colunas.
Endpoints Disponíveis
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /bi/v1/assets | Listar todos os ativos em formato simplificado |
| GET | /bi/v1/assets/count | Obter contagem total de ativos |
| GET | /bi/v1/assets/{id} | Obter um ativo específico por ID |
Listar Todos os Ativos
Retorna uma lista paginada de ativos com todos os campos simplificados no nível raiz. Ideal para exportação em massa de dados para ferramentas BI.
Parâmetros de Consulta
| status | Filtrar por status do ativo (ex., ACTIVE, INACTIVE) |
| policy | Filtrar por nome do caminho da política atribuída |
| page | Número da página (indexado a partir de 0, padrão: 0) |
| size | Tamanho da página (padrão: 20, máximo: 100) |
| sort | Campo de ordenação e direção (ex., lastSyncAt,desc) |
curl "https://api.nomid.tech/emm/api/bi/v1/assets?page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."Obter Contagem de Ativos
Retorna a contagem total de ativos que correspondem aos critérios de filtro. Útil para cálculos de paginação.
GET /bi/v1/assets/countObter Ativo Específico
Retorna um único ativo em formato simplificado pelo seu ID de ativo.
GET /bi/v1/assets/{id}Esquema BiAssetDto
Cada objeto de ativo segue a estrutura plana BiAssetDto. Todos os campos são strings no nível raiz - sem objetos aninhados ou arrays.
| Campo | Descrição |
|---|---|
| pathName | Caminho completo do ativo (ex., enterprises/acme/assets/abc123) |
| identification | Identificador amigável do ativo |
| name | Nome do dispositivo |
| description | Descrição do dispositivo |
| serialNumber | Número de série do dispositivo |
| imeis | Números IMEI (separados por vírgulas se múltiplos) |
| brand | Fabricante/marca do dispositivo |
| model | Nome do modelo do dispositivo |
| status | Status do ativo (ACTIVE, INACTIVE) |
| lastSyncAt | Timestamp da última sincronização (ISO 8601) |
| enrollmentTime | Timestamp de inscrição do dispositivo (ISO 8601) |
| policyPathName | Caminho completo da política atribuída |
| policyDisplayName | Nome legível da política |
| policyGroupName | Grupo de política para categorização |
| metadata | Metadados personalizados como string JSON |
| tags | Tags como string separada por vírgulas |
| operatingSystem | Nome do SO (ex., Android) |
| operatingSystemVersion | Número da versão do SO |
API Pública vs API BI
A principal diferença é a estrutura de resposta. A API Pública usa objetos aninhados para organização, enquanto a API BI simplifica tudo para mapeamento fácil de colunas.
Paginação
Os resultados são paginados usando o mesmo formato da API Pública. Use os parâmetros page e size para navegar por grandes conjuntos de dados.