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": "enterprises/acme/assets/asset_123abc",
"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
A API inclui cabeçalhos de limite de taxa em cada resposta. Monitore-os para evitar atingir os limites.
| HTTP | 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 |