API de Ativos
Endpoints para acessar informações de ativos em sua organização. Ativos representam itens de inventário que podem ou não estar inscritos como dispositivos gerenciados.
Endpoints Disponíveis
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /assets | Listar todos os ativos com paginação e filtros |
| GET | /assets/count | Obter contagem total de ativos |
| GET | /assets/{id} | Obter detalhes de um ativo específico |
Listar Ativos
Retorna uma lista paginada de ativos com filtros opcionais. Os resultados são ordenados por syncedAt decrescente por padrão.
Parâmetros de Consulta
| Campo | Descrição |
|---|---|
| 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., syncedAt,desc) |
curl "https://api.nomid.tech/emm/api/v1/assets?page=0&size=20" \
-H "X-API-Key: nm_acme_abc123..."Obter Contagem de Ativos
Retorna a contagem total de ativos que correspondem aos critérios de filtro. Suporta os mesmos parâmetros de filtro do endpoint de listagem.
GET /assets/countObter Ativo
Retorna informações detalhadas sobre um ativo específico pelo seu ID, incluindo todos os objetos aninhados.
GET /assets/{id}Esquema de Resposta
Cada objeto de ativo segue a estrutura PublicAssetDto com objetos aninhados para dados personalizados, especificações de hardware e informações do dispositivo gerenciado.
Campos de Nível Superior
| pathName | Caminho completo do ativo na hierarquia (ex., enterprises/acme/assets/asset_abc123) |
| identification | Identificador amigável ou nome de exibição do ativo |
| status | Status atual do ativo (ACTIVE, INACTIVE, etc.) |
| syncedAt | Timestamp ISO 8601 da última sincronização |
| customData | Objeto contendo metadados personalizados e tags |
| specifications | Objeto contendo especificações de hardware |
| managedDevice | Objeto contendo informações do dispositivo EMM, ou null se não estiver inscrito |
Objeto customData
Pares chave-valor de metadados personalizados (ex., departamento, localização)
Array de tags de texto para categorização
Objeto specifications
Número de série do dispositivo
Nome do modelo do dispositivo
Objeto managedDevice
Este objeto é null quando o ativo não está inscrito como dispositivo gerenciado no sistema EMM.
Paginação
Endpoints de listagem retornam resultados paginados usando o formato Page do Spring: