Começando

Comece a usar a API do Nomid MDM em apenas alguns minutos. Este guia irá orientá-lo na configuração de autenticação e na sua primeira chamada de API.

Pré-requisitos

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

Passo 1: Criar uma Chave de API

Faça login no Portal Nomid em portal.nomid.tech
Navegue até Configurações da Empresa > Integrações
Clique em 'Criar Chave de API' e dê um nome descritivo
Copie a chave de API - ela será exibida apenas uma vez!

Passo 2: Faça Sua Primeira Solicitação

Use sua chave de API para autenticar solicitações. 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: Trate a Resposta

A API retorna respostas JSON. Aqui está 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. Use os parâmetros 'page' e 'size' para navegar pelos resultados.

Limites de taxa

Os endpoints de leitura REST não aplicam um limite por chave no aplicativo Nomid, mas crie seu cliente para realizar backoff no erro 429 mesmo assim. O endpoint MCP permite 60 solicitações por minuto por chave. Comandos de dispositivo, alterações de política (cada chamada de propor e aplicar) e códigos QR de provisionamento compartilham um limite de gravação de 10 por minuto por chave, em todos os endpoints REST e ferramentas MCP. Uma conexão de Sign in with Nomid possui os mesmos limites de MCP e de gravação, contabilizados por conexão.

HTTP	Descrição
Retry-After	Segundos para aguardar antes de tentar novamente. Enviado com respostas HTTP 429 do endpoint MCP, dos endpoints de comando REST, dos endpoints de alteração de política e do endpoint de código QR de provisionamento.

A API não envia os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining ou X-RateLimit-Reset.

Próximos Passos

Explorar Endpoints de Ativos Aprender sobre Políticas Referência da API