Comenzar

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

1. Inicia sesión en el Portal de Nomid en portal.nomid.tech
2. Navega a Configuración de la Empresa > Integraciones
3. Haz clic en 'Crear Clave API' y dale un nombre descriptivo
4. 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",
      "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
}

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.