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

GET/api/v1/assets

Listar todos os ativos com paginação e filtros

GET/api/v1/assets/count

Obter contagem total de ativos

GET/api/v1/assets/{assetId}

Obter detalhes de um ativo específico

GET/api/v1/assets

Retorna uma lista paginada de ativos com filtros opcionais. Os resultados são ordenados por syncedAt decrescente por padrão.

Parâmetros de Consulta

Name	Type	Required	Description
`status`	string	Optional	Filtrar por status do ativo (ex., ACTIVE, INACTIVE)
`policy`	string	Optional	Filtrar por nome do caminho da política atribuída
`page`	integer	Optional	Número da página (indexado a partir de 0, padrão: 0)(default: `0`)
`size`	integer	Optional	Tamanho da página (padrão: 20, máximo: 100)(default: `20`)
`sort`	string	Optional	Campo de ordenação e direção (ex., syncedAt,desc)

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets?status=ACTIVE&page=0&size=20" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "content": [
    {
      "pathName": "enterprises/acme/assets/asset_abc123",
      "identification": "Warehouse Scanner 01",
      "status": "ACTIVE",
      "syncedAt": "2026-01-29T08:15:00Z",
      "customData": {
        "metadata": {
          "department": "logistics",
          "location": "warehouse-a"
        },
        "tags": ["warehouse", "scanner", "critical"]
      },
      "specifications": {
        "imeis": ["123456789012345"],
        "serialNumber": "ABC123XYZ",
        "model": "Galaxy Tab Active3",
        "brand": "Samsung",
        "os": "Android",
        "osVersion": "13"
      },
      "managedDevice": {
        "pathName": "enterprises/acme/devices/device_xyz789",
        "name": "Warehouse Scanner 01",
        "status": "ACTIVE",
        "policyPathName": "enterprises/acme/policies/warehouse",
        "enrollmentTime": "2025-01-15T10:30:00Z"
      }
    }
  ],
  "totalElements": 156,
  "totalPages": 8,
  "size": 20,
  "number": 0
}

GET/api/v1/assets/count

Retorna a contagem total de ativos que correspondem aos critérios de filtro. Suporta os mesmos parâmetros de filtro do endpoint de listagem.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/count?status=ACTIVE" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "count": 156
}

GET/api/v1/assets/{assetId}

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

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/asset_abc123" \
  -H "X-API-Key: nm_acme_abc123..."

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

Name	Type	Required	Description
`pathName`	string	Required	Caminho completo do ativo na hierarquia (ex., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Identificador amigável ou nome de exibição do ativo
`status`	string	Required	Status atual do ativo (ACTIVE, INACTIVE, etc.)
`syncedAt`	string	Required	Timestamp ISO 8601 da última sincronização
`customData`	object	Optional	Objeto contendo metadados personalizados e tags
`specifications`	object	Optional	Objeto contendo especificações de hardware
`managedDevice`	object \| null	Optional	Objeto contendo informações do dispositivo EMM, ou null se não estiver inscrito

Objeto customData

Name	Type	Required	Description
`metadata`	object	Optional	Pares chave-valor de metadados personalizados (ex., departamento, localização)
`tags`	string[]	Optional	Array de tags de texto para categorização

Objeto specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Array de números IMEI do dispositivo
`serialNumber`	string	Optional	Número de série do dispositivo
`model`	string	Optional	Nome do modelo do dispositivo
`brand`	string	Optional	Fabricante/marca do dispositivo
`os`	string	Optional	Nome do sistema operacional (ex., Android)
`osVersion`	string	Optional	Versão do sistema operacional

Objeto managedDevice

Este objeto é null quando o ativo não está inscrito como dispositivo gerenciado no sistema EMM.

Name	Type	Required	Description
`pathName`	string	Required	Caminho do dispositivo no sistema EMM
`name`	string	Required	Nome de exibição do dispositivo no EMM
`status`	string	Required	Status do dispositivo EMM (ACTIVE, PROVISIONING, DISABLED, etc.)
`policyPathName`	string	Required	Caminho da política atribuída
`enrollmentTime`	string	Required	Timestamp ISO 8601 quando o dispositivo foi inscrito

Paginação

Endpoints de listagem retornam resultados paginados usando o formato Page do Spring:

content - Array de objetos de ativo para a página atual
totalElements - Número total de ativos que correspondem à consulta
totalPages - Número total de páginas disponíveis
size - Tamanho de página solicitado
number - Número da página atual (indexado a partir de 0)

Nota

O tamanho máximo de página é 100. Solicitações com size > 100 serão limitadas a 100.

Name

Type

Required

Description

status

string

Optional

Filtrar por status do ativo (ex., ACTIVE, INACTIVE)

policy

string

Optional

Filtrar por nome do caminho da política atribuída

page

integer

Optional

Número da página (indexado a partir de 0, padrão: 0)(default: 0)

size

integer

Optional

Tamanho da página (padrão: 20, máximo: 100)(default: 20)

sort

string

Optional

Campo de ordenação e direção (ex., syncedAt,desc)

{ "content": [ { "pathName": "enterprises/acme/assets/asset_abc123", "identification": "Warehouse Scanner 01", "status": "ACTIVE", "syncedAt": "2026-01-29T08:15:00Z", "customData": { "metadata": { "department": "logistics", "location": "warehouse-a" }, "tags": ["warehouse", "scanner", "critical"] }, "specifications": { "imeis": ["123456789012345"], "serialNumber": "ABC123XYZ", "model": "Galaxy Tab Active3", "brand": "Samsung", "os": "Android", "osVersion": "13" }, "managedDevice": { "pathName": "enterprises/acme/devices/device_xyz789", "name": "Warehouse Scanner 01", "status": "ACTIVE", "policyPathName": "enterprises/acme/policies/warehouse", "enrollmentTime": "2025-01-15T10:30:00Z" } } ], "totalElements": 156, "totalPages": 8, "size": 20, "number": 0 }

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

Name	Type	Required	Description
`pathName`	string	Required	Caminho completo do ativo na hierarquia (ex., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Identificador amigável ou nome de exibição do ativo
`status`	string	Required	Status atual do ativo (ACTIVE, INACTIVE, etc.)
`syncedAt`	string	Required	Timestamp ISO 8601 da última sincronização
`customData`	object	Optional	Objeto contendo metadados personalizados e tags
`specifications`	object	Optional	Objeto contendo especificações de hardware
`managedDevice`	object \| null	Optional	Objeto contendo informações do dispositivo EMM, ou null se não estiver inscrito

Objeto customData

Name	Type	Required	Description
`metadata`	object	Optional	Pares chave-valor de metadados personalizados (ex., departamento, localização)
`tags`	string[]	Optional	Array de tags de texto para categorização

Objeto specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Array de números IMEI do dispositivo
`serialNumber`	string	Optional	Número de série do dispositivo
`model`	string	Optional	Nome do modelo do dispositivo
`brand`	string	Optional	Fabricante/marca do dispositivo
`os`	string	Optional	Nome do sistema operacional (ex., Android)
`osVersion`	string	Optional	Versão do sistema operacional

Objeto managedDevice

Este objeto é null quando o ativo não está inscrito como dispositivo gerenciado no sistema EMM.

Name	Type	Required	Description
`pathName`	string	Required	Caminho do dispositivo no sistema EMM
`name`	string	Required	Nome de exibição do dispositivo no EMM
`status`	string	Required	Status do dispositivo EMM (ACTIVE, PROVISIONING, DISABLED, etc.)
`policyPathName`	string	Required	Caminho da política atribuída
`enrollmentTime`	string	Required	Timestamp ISO 8601 quando o dispositivo foi inscrito

Paginação

Endpoints de listagem retornam resultados paginados usando o formato Page do Spring:

content - Array de objetos de ativo para a página atual

totalElements - Número total de ativos que correspondem à consulta

totalPages - Número total de páginas disponíveis

size - Tamanho de página solicitado

number - Número da página atual (indexado a partir de 0)

Nota

O tamanho máximo de página é 100. Solicitações com size > 100 serão limitadas a 100.