Comenzar
Comienza a usar la API de Nomid MDM en solo unos minutos. Esta guía te llevará a través de la configuración de autenticación y tu primera llamada a la API.
Requisitos Previos
- Una cuenta de Nomid MDM con acceso de administrador
- Acceso a la Configuración de la Empresa en el Portal
- Una herramienta para hacer solicitudes HTTP (curl, Postman, o tu lenguaje preferido)
Paso 1: Crear una Clave API
- Inicia sesión en el Portal de Nomid en portal.nomid.tech
- Navega a Configuración de la Empresa > Integraciones
- Haz clic en 'Crear Clave API' y dale un nombre descriptivo
- Copia la clave API - ¡solo se mostrará una vez!
Paso 2: Haz Tu Primera Solicitud
Usa tu clave API para autenticar las solicitudes. Inclúyela en el encabezado X-API-Key:
curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
-H "X-API-Key: nm_acme_abc123..."Paso 3: Maneja la Respuesta
La API devuelve respuestas JSON. Aquí hay un ejemplo de respuesta del 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
}Las respuestas están paginadas. Usa los parámetros 'page' y 'size' para navegar por los resultados.
Límites de Velocidad
La API incluye encabezados de límite de velocidad en cada respuesta. Monitoréalos para evitar alcanzar los límites.
| HTTP | Descripción |
|---|---|
| X-RateLimit-Limit | Máximo de solicitudes permitidas por minuto |
| X-RateLimit-Remaining | Solicitudes restantes en la ventana actual |
| X-RateLimit-Reset | Marca de tiempo Unix cuando se reinicia el límite |