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!
Importante
Armazene sua chave de API de forma segura. Ela será exibida apenas uma vez ao ser criada. Se você perdê-la, precisará criar uma nova.
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..."Tip
You can test these examples directly in your terminal or browser console. Make sure to replace the API key with your own.
Passo 3: Trate a Resposta
A API retorna respostas JSON. Aqui está um exemplo de resposta do endpoint de dispositivos:
Responsejson
{
"content": [
{
"pathName": "enterprises/acme/assets/asset_123abc",
"identification": "Warehouse-Scanner-01",
"status": "ACTIVE",
"syncedAt": "2026-01-20T14:22:00Z",
"customData": {
"metadata": { "department": "Warehouse", "location": "Building A" },
"tags": ["scanner", "warehouse"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123456",
"model": "TC52",
"brand": "Zebra",
"os": "Android",
"osVersion": "13"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_123abc",
"name": "devices/device_123abc",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse",
"enrollmentTime": "2026-01-15T10:30: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
A API inclui cabeçalhos de limite de taxa em cada resposta. Monitore-os para evitar atingir os limites.
| Header | Descrição |
|---|---|
| X-RateLimit-Limit | Máximo de solicitações permitidas por minuto |
| X-RateLimit-Remaining | Solicitações restantes na janela atual |
| X-RateLimit-Reset | Timestamp Unix quando o limite de taxa é reiniciado |