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
GET	/assets/summary	Obtenha números agregados da frota: totais, detalhamento de status e um resumo da postura de segurança
GET	/assets/{id}/commands	Listar os comandos mais recentes enviados a um dispositivo

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: 50, máx.: 100)
sort	Campo de ordenação e direção (ex., syncedAt,desc)
lastSeenBefore	Apenas ativos vistos pela última vez antes deste instante ISO-8601, por exemplo 2026-01-01T00:00:00Z. Não deve estar no futuro nem antes de 1970-01-01T00:00:00Z. Também compatível com /assets/count.

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/count

Obter Ativo

Retorna informações detalhadas sobre um ativo específico pelo seu ID, incluindo todos os objetos aninhados.

GET /assets/{id}

Encontrar dispositivos não vistos recentemente

lastSeenBefore restringe uma lista ou contagem a dispositivos cujo registro foi atualizado pela última vez antes do instante informado, o que é uma maneira prática de encontrar dispositivos offline. Ele opera na granularidade de minutos, portanto, um dispositivo atualizado até 59 segundos após o instante ainda poderá ser incluído.

curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
  -H "X-API-Key: $NOMID_API_KEY"

Resumo da frota

GET /assets/summary precisa de DEVICES_READ e retorna apenas números agregados, nunca uma lista de dispositivos.

totalDevices	Número total de dispositivos.
devicesByStatus	Contagens de dispositivos indexadas por status.
securityPosture	Contagens de segurança como secureCount, atRiskCount e potentiallyCompromisedCount. riskyDeviceIds lista até 10 nomes de caminho de dispositivos, do pior para o melhor. riskyDeviceCount é o total real, e riskyDeviceIdsTruncated informa se a lista foi truncada.

As contagens de postura de segurança excluem dispositivos Pico. O totalDevices no nível raiz não os exclui.

Histórico de comandos

GET /assets/ASSET_ID/commands precisa de DEVICES_READ e retorna os comandos mais recentes enviados a um dispositivo, do mais recente ao mais antigo. limit usa como padrão 20 e é limitado a 50. Um limit inferior a 1 retorna 400, e um ativo desconhecido retorna 404.

type	O tipo de comando, por exemplo LOCK ou NOTIFICATION_MESSAGE.
status	IN_PROGRESS, EXPIRED, SUCCESS ou ERROR.
createdAt	Quando o comando foi criado.
feedbackAt	Quando o dispositivo ou provedor reportou de volta, se o tiver feito.
outcome	Um código curto que explica o status ERROR ou EXPIRED.

curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
  -H "X-API-Key: $NOMID_API_KEY"

Payloads de comando e dados confidenciais nunca são retornados.

Envie comandos com a API de comandos de dispositivo

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	Identificador único de ativo: um código curto como k3x9m2pa, sem barras. Use-o como o ID do ativo em URLs, por exemplo /assets/k3x9m2pa.
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: