Primeiros Passos

Comece a trabalhar com a API Nomid MDM em apenas alguns minutos. Este guia irá orientá-lo na configuração da autenticação e na realização da sua primeira chamada à API.

Pré-requisitos

Uma conta Nomid MDM com acesso de administrador
Acesso às Definições da Empresa no Portal
Uma ferramenta para efetuar pedidos HTTP (curl, Postman ou a sua linguagem preferida)

Passo 1: Criar uma chave de API

Inicie sessão no Portal Nomid em portal.nomid.tech
Navegue até Definições da empresa > Integrações
Clique em 'Criar chave de API' e atribua-lhe um nome descritivo
Copie a chave de API – só será apresentada uma vez!

Passo 2: Faça o seu primeiro pedido

Utilize a sua chave de API para autenticar pedidos. Inclua-a no cabeçalho X-API-Key:

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

Passo 3: Processe a resposta

A API devolve respostas em JSON. Eis um exemplo de resposta do endpoint de dispositivos:

{
  "content": [{
    "pathName": "k3x9m2pa",
    "identification": "Warehouse-Scanner-01",
    "status": "ACTIVE",
    "syncedAt": "2026-01-20T14:22:00Z"
  }],
  "totalElements": 1,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

As respostas são paginadas. Utilize os parâmetros de consulta 'page' e 'size' para navegar pelos resultados.

Limites de pedidos

A API inclui cabeçalhos de limite de pedidos em todas as respostas. Monitorize-os para evitar atingir os limites.

HTTP	Descrição
X-RateLimit-Limit	Número máximo de pedidos permitidos por minuto
X-RateLimit-Remaining	Pedidos restantes na janela atual
X-RateLimit-Reset	Timestamp Unix em que o limite de pedidos é reposto

Passos seguintes

Explorar endpoints de ativos Saber mais sobre políticas Referência da API